cursor.isExhausted()
Nesta página
cursor.isExhausted()
Importante
Método mongosh
Este é um método
mongosh
. Esta não é a documentação deNode.js
ou de outros métodos de driver específicos da linguagem de programação.Na maioria dos casos, os métodos
mongosh
funcionam da mesma forma que os métodos legado do shellmongo
. No entanto, alguns métodos legado não estão disponíveis emmongosh
.Para a documentação do shell legado
mongo
, consulte a documentação para a release correspondente do MongoDB Server:Para drivers da API do MongoDB, consulte a documentação do driver do MongoDB específica do idioma.
Retorna: Boolean cursor.isExhausted()
retornafalse
se os documentos permanecerem no lote de documento atual lido pelo cursor. Caso contrário, retornatrue
.
Compatibilidade
Esse método está disponível em implantações hospedadas nos seguintes ambientes:
MongoDB Atlas: o serviço totalmente gerenciado para implantações do MongoDB na nuvem
Observação
Este comando é aceito em todos os clusters do MongoDB Atlas. Para obter informações sobre o suporte do Atlas a todos os comandos, consulte Comandos não suportados.
MongoDB Enterprise: a versão autogerenciada e baseada em assinatura do MongoDB
MongoDB Community: uma versão com código disponível, de uso gratuito e autogerenciada do MongoDB
Comportamento
Cursores persistentes
Você pode usar isExhausted()
com um cursor persistente. Um cursor persistente permanece aberto mesmo que nenhum documento permaneça no lote atual. Outros cursores são fechados automaticamente quando nenhum documento permanece.
Fluxos de alterações
Você não pode usar o isExhausted()
com fluxos de alteração . Em vez disso, para examinar se:
documento permanecem em um cursor de change stream, use
cursor.tryNext()
.um cursor de fluxo de alterações estiver fechado, use
cursor.isClosed()
.
Para ver um exemplo de change stream, consulte Exemplo de observação.
Exemplos
Esta seção contém exemplos que usam um cursor para ler documento de uma collection com leituras de temperatura de um sensor meteorológico. Você verá exemplos de isExhausted()
.