next() (次のドキュメントの取得)

最終更新：2026-10-09

next() (次のドキュメントの取得)

next() はカーソルの次のドキュメントを返し、カーソルを進めます: `db.users.find().next()`。カーソルを使い果たした後に呼ぶとエラーを投げるため、hasNext() と組み合わせます: `while (cursor.hasNext()) { const doc = cursor.next() }`。手動カーソル反復の低レベルプリミティブです。

📝 構文

db.<collection>.find(<filter>).next()

戻り値：次のドキュメント。カーソルが尽きている場合は例外を送出。

▶ 例

以下のコマンドをローカルの mongosh で実行してください（mongod が起動済みである必要があります）：

// next: 最初の3ドキュメントを手動で取得する
const cursor = db.users.find()
for (let i = 0; i < 3; i++) {
  print(cursor.next().name)
}

出力：

Alice
Bob
Cara

📌 注意事項

• カーソルを使い果たすと next() はエラーを投げる
• 安全な反復には hasNext() と組み合わせる
• 前方向のみ。後ろに戻れない

🏷️ 関連タグ

💡 関連ケース

📚 関連チュートリアル

❓ よくある質問

Web-Tutorial 技術チーム

複数の開発者によって共同維持されているプログラミングチュートリアルプラットフォーム。各チュートリアルは専門分野の開発者が執筆・レビューしています。正確で信頼性の高いコンテンツを目指しています — 問題を見つけた場合はお知らせください。

私たちについて