cursor.forEach()

Description

cursor.forEach(function)

Important

mongosh Method

This page documents a mongosh method. This is not the documentation for a language-specific driver, such as Node.js.

For MongoDB API drivers, refer to the language-specific MongoDB driver documentation.

Iterates the cursor to apply a JavaScript function to each document from the cursor.

The forEach() method has the following prototype form:

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

The forEach() method has the following parameter:

Parameter	Type	Description
function	JavaScript	A JavaScript function to apply to each document from the cursor. The <function> signature includes a single argument that is passed the current document to process.

Example

The following example invokes the forEach() method on the cursor returned by find() to print the name of each user in the collection:

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