cursor.forEach()
定義
cursor.forEach(function)
重要
mongosh メソッド
これは
mongosh
メソッドです。 これは、Node.js
またはその他のプログラミング言語固有のドライバー メソッドのドキュメントではありません。ほとんどの場合、
mongosh
メソッドはレガシーのmongo
shell メソッドと同じように動作します。 ただし、一部のレガシー メソッドはmongosh
では利用できません。レガシー
mongo
shell のドキュメントについては、対応する MongoDB Server リリースのドキュメントを参照してください。MongoDB API ドライバーについては、各言語のMongoDB ドライバードキュメント を参照してください。
カーソルを反復して、カーソルからの各ドキュメントに JavaScript
function
を適用します。
互換性
このメソッドは、次の環境でホストされている配置で使用できます。
MongoDB Atlas はクラウドでの MongoDB 配置のためのフルマネージド サービスです
注意
このコマンドは、すべての MongoDB Atlas クラスターでサポートされています。すべてのコマンドに対する Atlas のサポートについては、「サポートされていないコマンド」を参照してください。
MongoDB Enterprise: サブスクリプションベースの自己管理型 MongoDB バージョン
MongoDB Community: ソースが利用可能で、無料で使用できる自己管理型の MongoDB のバージョン
構文
このメソッドの構文は次のとおりです。
db.collection.find().forEach( <function> )
メソッド フィールド
このメソッドは次のフィールドを受け入れます。
フィールド | タイプ | 説明 |
---|---|---|
| JavaScript コード | カーソルから返される各ドキュメントに適用する関数。関数シグネチャには、カーソルから読み取られた現在のドキュメントを格納する 1 つのフィールドが含まれます。 |
例
users
コレクションを次のように作成します。
db.users.insertMany( [ { name: "John" }, { name: "Jane" } ] )
次の例では、find()
メソッドで forEach()
を使用して、users
コレクションから読み取られたユーザー名を出力します。myDoc
は現在のドキュメントを格納します。
db.users.find().forEach( function( myDoc ) { print( "User name: " + myDoc.name ) } )
出力例:
User name: John User name: Jane
mongosh
2.1.0以降、 for-of
ループを使用することもできます。 次の例では、前の例と同じ結果が返されます。
for ( const myDoc of db.users.find() ) { print( "User name: " + myDoc.name ) }
詳細
同様の機能を持つメソッドについては、 cursor.map()
を参照してください。