cursor.isExhausted()Importante
Método mongosh
This page documents a
mongoshmethod. This is not the documentation for a language-specific driver, such as Node.js.Para drivers de API do MongoDB, consulte a documentação do driver do MongoDB específica da linguagem.
Retorna: Boolean
cursor.isExhausted()returnsfalseif documents remain in the current document batch read by the cursor. Otherwise, returnstrue.
Compatibilidade
Esse método está disponível em implantações hospedadas nos seguintes ambientes:
- MongoDB Atlas: The fully managed service for MongoDB deployments in the cloud
Observação
This command is supported in all MongoDB Atlas clusters. For information on Atlas support for all commands, see Unsupported Commands.
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 exemplos de change stream, consulte Exemplo de Assista e Exemplo de Imagens de change stream.
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().