Docs Menu

Docs HomeDevelop ApplicationsMongoDB Manual


On this page

  • Definition
  • Syntax
  • Method Fields
  • Examples
  • Learn More


mongo Shell Method

This page documents the mongo shell method, and does not refer to the MongoDB Node.js driver (or any other driver) method. For corresponding MongoDB driver API, refer to your specific MongoDB driver documentation instead.

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

The method has the following syntax:

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

The method accepts the following field:

JavaScript code
Function to apply to each document returned from the cursor. The function signature includes one field that stores the current document that is read from the cursor.

Create the users collection:

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

The following example uses forEach() with the find() method to print the user names that are read from the users collection. myDoc stores the current document.

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

Example output:

User name: John
User name: Jane

Starting in mongosh 2.1.0, you can also use for-of loops. The following example returns the same results as the previous example:

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

For a method that has similar functionality, see

← cursor.explain()