cursor.forEach()

Definição

cursor.forEach(function)

Importante

Método mongosh

Este é um método mongosh . Esta não é a documentação de Node.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 shell mongo . No entanto, alguns métodos legado não estão disponíveis em mongosh.

Para a documentação do shell legado mongo, consulte a documentação para a release correspondente do MongoDB Server:

• mongo shell v4.4

• mongo shell v4,2

• mongo shell v4.0

Para drivers da API do MongoDB, consulte a documentação do driver do MongoDB específica do idioma.

Itera o cursor para aplicar um JavaScript function a cada documento a partir do cursor.

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

• 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

Sintaxe

O método tem a seguinte sintaxe:

db.collection.find().forEach( <function> )

Campos de método

O método aceita o seguinte campo:

Exemplos

Crie a coleção users:

db.users.insertMany( [
   { name: "John" },
   { name: "Jane" }
] )

O exemplo seguinte utiliza forEach() com o método find() para imprimir os nomes de usuário que são lidos a partir da coleção users. myDoc armazena o documento atual.

db.users.find().forEach( function( myDoc ) {
   print( "User name: " + myDoc.name )
} )

Saída de exemplo:

User name: John
User name: Jane

A partir de mongosh 2.1.0, você também pode usar for-of loops. O exemplo a seguir retorna os mesmos resultados do exemplo anterior:

for ( const myDoc of db.users.find() ) {
   print( "User name: " + myDoc.name )
}

Saiba mais

Para um método que tem funcionalidade semelhante, consulte cursor.map().