cursor.forEach()
Definição
cursor.forEach(function)
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.
Itera o cursor para aplicar um JavaScript
function
a cada documento a partir do cursor.
Sintaxe
O método tem a seguinte sintaxe:
db.collection.find().forEach( <function> )
Campos de método
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. |
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()
.