JavaScript

find() とは？

find() は、「配列の中から条件に合う“最初の１つ”を見つける」ためのメソッドです。

つまり、リストの中を上から順番に見ていって、「これだ！」と思った最初の要素を返してくれます。

見つからなかった場合は undefined（何もない状態）になります。

使い方の形

こう書けばOKです：

配列.find(要素 => 条件);

たとえば、数字の中から10より大きい最初の値を探したいとき：

const numbers = [3, 7, 12, 18];
const result = numbers.find(num => num > 10);
console.log(result); // 12

上の例では、最初に条件を満たした「12」が見つかったので、それを返します。

もし配列の中に10より大きい数字がなければ、undefined になります。

ポイント

• 条件に「合うもの」がいくつあっても、最初の１つしか返しません。
• 条件を関数（コールバック）で書くのがポイントです。
• 見つからないときは undefined になるので、エラーではありません。
• もし「すべての該当データ」を取り出したいなら、filter() を使います。

ちょっと正確な説明

find() は、配列の各要素を順番に調べて、テスト関数が true を返す最初の要素を返します。

返り値はその「要素」そのものです（インデックスではありません）。

ECMAScript（JavaScriptの標準仕様）に定義された、配列専用のメソッドです。