MongoDBのfind()メソッドとfindOne()メソッドの違いとは？実例でわかりやすく解説

MongoDBにおいて、findOne()はクエリに一致したドキュメントのうち最初の1件を返し、一致するドキュメントが存在しない場合はnullを返します。一方、find()メソッドはnullを返すことなく、必ずカーソル（cursor）オブジェクトを返します。これが両者の最も重要な違いです。

find()とfindOne()の動作を実例で確認しよう

ここでは、空のコレクションを使って両者の違いを実際に確かめてみます。まず、ドキュメントを1件も持たないコレクションを作成しましょう。

> db.createCollection('emptyCollection');
{ "ok" : 1 }

コレクション内のドキュメント数を確認

次に、作成したコレクション内のドキュメント数を数えてみます。

> db.emptyCollection.count();

実行結果：

0

このように、コレクションにはドキュメントが1件も存在していません。この状態で各メソッドがどのような値を返すのか検証します。

findOne()の結果を検証

空のコレクションに対してfindOne()を実行するとどうなるか確認してみましょう。

> if(db.emptyCollection.findOne()){print("Returns Cursor")} else {print("Not returning cursor")}

実行結果：

Not returning cursor

findOne()は一致するドキュメントが存在しないため、nullを返しました。

find()の結果を検証

続いて、同じく空のコレクションに対してfind()を実行してみます。

> if(db.emptyCollection.find()){print("Returns Cursor")} else {print("Not returning cursor")}

実行結果：

Returns Cursor

find()は条件に一致するドキュメントが1件も存在しない場合でも、nullではなくカーソルオブジェクトを返すことが分かります。

まとめ：find()とfindOne()の使い分け

この実験から、両メソッドの違いは以下のように整理できます。

• findOne()：クエリに一致する最初のドキュメントを1件返し、見つからなければnullを返す
• find()：常にカーソルを返し、一致するドキュメントがなくてもnullを返すことはない

そのため、ドキュメントの存在チェックや単一データの取得を行う場合はfindOne()、複数件を扱う処理やカーソル操作が必要な場合はfind()といったように、戻り値の型の違いを理解した上で適切に使い分けることが重要です。