Menu Docs
Página inicial do Docs
/
Manual do MongoDB
/ / /

cursor.forEach()

Nesta página

  • Definição
  • Sintaxe
  • Campos de método
  • Exemplos
  • Saiba mais
cursor.forEach(function)

Importante

Método mongosh

Esta página documenta um método mongosh . Esta não é a documentação para um driver específico de idioma, como Node.js.

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

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

O método tem a seguinte sintaxe:

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

O método aceita o seguinte campo:

Campo
Tipo
Descrição
function
Código JavaScript
Função a ser aplicada a cada documento retornado do cursor. A assinatura de função inclui um campo que armazena o documento atual que é lido no cursor.

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 )
}

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

← cursor.explain()