【Node.js24.x】Array::find()メソッドの使い方
findメソッドの使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
findメソッドは、配列内で特定の条件を満たす最初の要素を検索し、その要素を返すメソッドです。このメソッドは、引数として渡されるコールバック関数（テスト関数）を、配列の各要素に対して順番に実行します。テスト関数は、現在の要素、その要素のインデックス、およびfindメソッドが呼び出された元の配列自体を引数として受け取ります。
findメソッドは、テスト関数がtrueを返した最初の要素を見つけると、その要素を直ちに戻り値として返します。例えば、数値の配列から特定の条件（例: 10より大きい）を満たす最初の数を見つけたり、オブジェクトの配列から特定のプロパティ（例: IDが一致する）を持つ最初のオブジェクトを探したりする際に利用されます。
もし、配列のすべての要素に対してテスト関数が実行されても、一度もtrueを返す要素が見つからなかった場合、findメソッドはundefinedを返します。このメソッドは、元の配列の内容を直接変更することはありません（非破壊的な操作です）。配列の中から特定の基準に合致する単一の要素を効率的に取得したい場合に非常に役立ちます。
構文(syntax)
1const array = [10, 20, 30, 40, 50]; 2const foundElement = array.find(element => element > 25); 3console.log(foundElement);
引数(parameters)
callbackFn, thisArg
- callbackFn: (element, index, array) => boolean | undefined: 配列の各要素に対して実行されるコールバック関数。要素をテストし、
trueまたはundefined(またはfalse) を返します。 - thisArg?: any:
callbackFnが実行される際にthisとして使用される値。
戻り値(return)
T | undefined
配列内で、指定された条件を満たす最初の要素を返します。該当する要素がない場合は undefined を返します。