next() (Buscar Próximo Documento)
Última atualização: 2026-10-09
next() (Buscar Próximo Documento)
next() retorna o próximo documento de um cursor e o avança: `db.users.find().next()`. Chamá-lo depois que o cursor está esgotado lança um erro, então combine-o com hasNext(): `while (cursor.hasNext()) { const doc = cursor.next() }`. É o primitivo de baixo nível para iteração manual de cursor.
| Categoria | Cursor |
|---|---|
| Versão do MongoDB | 1.0+ |
| Idioma do Exemplo | mongosh (Shell) |
📝 Sintaxe
db.<collection>.find(<filter>).next()Retorno：O próximo documento; lança erro quando o cursor está esgotado.
▶ Exemplo
Execute os comandos abaixo no seu mongosh local (requer um mongod em execução):
// next: puxa manualmente os 3 primeiros documentos
const cursor = db.users.find()
for (let i = 0; i < 3; i++) {
print(cursor.next().name)
}Saída：
Alice
Bob
Cara📌 Notas
- next() lança erro quando o cursor está esgotado
- Combine com hasNext() para iteração segura
- Somente avanço — você não pode voltar
🏷️ Tags Relacionados
💡 Casos Relacionados
Integração do Express com o Mongoose: Arquitetura de aplicativos web
Modelos do Mongoose e projeto de esquemas
Validação de dados e middleware do Mongoose
API RESTful na prática: um guia completo para o projeto CRUD
📚 Tutoriais Relacionados
❓ Perguntas Frequentes
QO que acontece quando next() atinge o fim do cursor?
AEle lança erro. O padrão seguro é verificar hasNext() antes de chamar next().
QQual é a diferença entre next e tryNext?
Anext() lança erro no fim; tryNext() retorna null em vez disso, melhor para loops tolerantes a falhas.
QO next() pode voltar ao documento anterior?
ANão, cursors só avançam. Salve os resultados em um array para revisá-los.
