tryNext() (Tentar Buscar Próximo Documento)
Última atualização: 2026-10-09
tryNext() (Tentar Buscar Próximo Documento)
tryNext() tenta retornar o próximo documento do cursor, retornando null em vez de lançar erro no fim: `const doc = db.users.find().tryNext()`. Diferente de next(), que gera erro quando esgotado, tryNext() mantém o código de iteração seguro e conciso — ótimo para loops condicionais e leituras tolerantes a falhas.
| Categoria | Cursor |
|---|---|
| Versão do MongoDB | 1.0+ |
| Idioma do Exemplo | mongosh (Shell) |
📝 Sintaxe
db.<collection>.find(<filter>).tryNext()Retorno：O próximo documento; null quando o cursor está esgotado.
▶ Exemplo
Execute os comandos abaixo no seu mongosh local (requer um mongod em execução):
// tryNext: iteração segura sem hasNext
const cursor = db.users.find()
let doc
while ((doc = cursor.tryNext()) !== null) {
print(doc.name)
}Saída：
Alice
Bob
Cara📌 Notas
- Retorna null no fim em vez de lançar erro
- Pode substituir a dupla hasNext()+next()
- Pare a qualquer momento interrompendo o loop
🏷️ Tags Relacionados
💡 Casos Relacionados
Mais casos práticos em breve.
📚 Tutoriais Relacionados
❓ Perguntas Frequentes
QQual é a diferença entre tryNext e next?
ANo fim, next() lança erro enquanto tryNext() retorna null — o último itera com mais segurança.
QO tryNext pode substituir hasNext?
ASim — o padrão while ((doc = cursor.tryNext()) !== null) itera com segurança sem hasNext().
QO tryNext retornar null significa o fim?
ASim — null sinaliza que o cursor está esgotado e o loop deve parar.
