findOneAndUpdate() (更新してドキュメントを返す)

最終更新：2026-10-09

findOneAndUpdate() (更新してドキュメントを返す)

findOneAndUpdate() はフィルタに一致する最初のドキュメントを更新し、そのドキュメント自体を返します。更新前か更新後かは `returnDocument`: 'before'（デフォルト）または 'after' で制御します。例: `db.users.findOneAndUpdate({ name: 'Alice' }, { $set: { age: 22 } }, { returnDocument: 'after' })`。カウンタのみを返す updateOne() と異なり、ドキュメントを読み戻すため、カウンタやステートマシン遷移など、更新直後の値を必要とするフローに適しています。

📝 構文

db.<collection>.findOneAndUpdate(<filter>, <update>, { returnDocument: 'after', upsert: <bool> })

⚙️ パラメータ

戻り値：更新前（または更新後）のドキュメント。何もマッチせず upsert が無効の場合は null。

▶ 例

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

// findOneAndUpdate: Alice を更新し、新しいドキュメントを返す
const doc = db.users.findOneAndUpdate(
  { name: 'Alice' }, { $set: { age: 22 } },
  { returnDocument: 'after' }
)
doc

出力：

{
  _id: ObjectId('64c8a1b20000000000000001'),
  name: 'Alice',
  age: 22
}

📌 注意事項

• デフォルトでは更新前のドキュメントを返す。新値を得るには returnDocument: 'after' を設定する
• レガシードライバではこの機能を findAndModify + new オプションで呼ぶ
• updateOne() はカウンタを返す。ドキュメント自体が必要な場合はこのメソッドを使う

🏷️ 関連タグ

💡 関連ケース

📚 関連チュートリアル

❓ よくある質問

Web-Tutorial 技術チーム

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

私たちについて