【JavaScript ECMAScript】Array::Array.prototype.findインスタンスメソッドの使い方
Array.prototype.find()インスタンスメソッドの使い方について、初心者にもわかりやすく解説します。
基本的な使い方
Array.prototype.find()メソッドは、JavaScriptのArrayオブジェクトのインスタンスが持つメソッドで、配列の中から指定されたテスト関数（コールバック関数）によって提供された条件を満たす最初の要素の値を返すことを実行するメソッドです。
このメソッドは、配列の各要素に対して一度ずつコールバック関数を実行します。コールバック関数は、現在の要素の値、その要素のインデックス、そしてfind()が呼び出された元の配列自身を引数として受け取ります。このコールバック関数は、要素が指定された条件を満たすかどうかを評価し、真偽値を返す必要があります。
find()メソッドは、コールバック関数がtrueを返した最初の要素を見つけると、その要素の値を直ちに返します。その後、残りの配列要素に対してはコールバック関数を実行しません。もし配列のすべての要素を検索しても、どの要素も指定された条件を満たさなかった場合、このメソッドはundefinedを返します。
このメソッドの重要な特徴として、呼び出し元の配列自体は変更されないという点が挙げられます。元の配列のデータはそのまま保持され、find()メソッドは検索結果のみを返します。ECMAScript 2015（ES6）で導入されて以来、配列内の特定の要素を効率的かつ安全に検索するための標準的な方法として、様々なプログラミングシナリオで広く利用されています。これにより、配列操作の可読性と保守性が向上します。
構文(syntax)
1const array = [1, 2, 3, 4, 5]; 2const foundElement = array.find(element => element > 3);
引数(parameters)
callbackFn, thisArg
- callbackFn: Array の各要素に対して実行されるコールバック関数。true を返した最初の要素を返します。
- thisArg: callbackFn が実行される際に、
thisとして使用される値。
戻り値(return)
undefined または 要素
指定された条件に一致する要素が見つかった場合は、その要素を返します。条件に一致する要素が一つも見つからなかった場合は、undefined を返します。