cursor.forEach()

Esta versión de la documentación está archivada y ya no recibe soporte. Para actualizar su implementación 5.0, consulte Procedimientos de actualización de MongoDB.6.0

Definición

cursor.forEach(function)

Importante

Método mongosh

Este es un método.mongosh Esta no es la documentación de Node.js ni de otros métodos de controlador específicos del lenguaje de programación.

En la mayoría de los casos, los métodos funcionan de la misma manera que losmongosh heredados. mongo Métodos de shell. Sin embargo, algunos métodos heredados no están disponibles mongosh en.

Para obtener la documentación del shell heredado, consulte la documentación de la versión correspondiente de MongoDB mongo Server:

Para los controladores de la API de MongoDB, consultar la documentación específica del controlador de MongoDB para cada lenguaje.

Itera el cursor para aplicar un JavaScript function a cada documento desde el cursor.

Compatibilidad

Este método está disponible en implementaciones alojadas en los siguientes entornos:

MongoDB Atlas: El servicio totalmente gestionado para implementaciones de MongoDB en la nube

Nota

Este comando es compatible con todos los clústeres de MongoDB Atlas. Para obtener información sobre el soporte de Atlas para todos los comandos, consulte Comandos no compatibles.

MongoDB Enterprise: La versión basada en suscripción y autogestionada de MongoDB
MongoDB Community: La versión de MongoDB con código fuente disponible, de uso gratuito y autogestionada.

Sintaxis

El método tiene la siguiente sintaxis:

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

Campos de método

El método acepta el siguiente campo:

Campo	Tipo	Descripción
`function`	Código JavaScript	Función que se aplica a cada documento devuelto por el cursor. La firma de la función incluye un campo que almacena el documento actual leído desde el cursor.

Ejemplos

Crear la colección users:

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

El siguiente ejemplo utiliza forEach() con el método para imprimir los nombres de usuario que se leen de find() la users colección. myDoc almacena el documento actual.

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

Ejemplo de salida:

User name: John
User name: Jane

A partir de mongosh 2.1.0, también se pueden usar bucles for-of. El siguiente ejemplo devuelve los mismos resultados que el ejemplo anterior:

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

Obtén más información

Para un método que tiene una funcionalidad similar,cursor.map() consulte.

Volver

cursor.explain

cursor.hasNext