【JavaScript ECMAScript】Array::Array.prototype.someインスタンスメソッドの使い方
Array.prototype.some()インスタンスメソッドの使い方について、初心者にもわかりやすく解説します。
基本的な使い方
Array.prototype.some()メソッドは、配列のいずれかの要素が指定されたテスト関数によって提供される条件を少なくとも一つ満たすかどうかを確認するメソッドです。このメソッドは、引数としてコールバック関数を受け取ります。このコールバック関数は、配列内の各要素に対して一度ずつ実行され、要素が条件を満たすかどうかを評価します。もし配列の要素のうち、たった一つでもコールバック関数が真(true)を返した場合、Array.prototype.some()メソッドは直ちに真を返し、それ以上の要素に対するチェックは行いません。配列内のすべての要素に対してコールバック関数が偽(false)を返した場合、Array.prototype.some()メソッドは最終的に偽を返します。
コールバック関数は、現在の要素の値、その要素のインデックス、および対象の配列自体を引数として受け取ることが可能です。また、オプションでコールバック関数内でthisとして使用する値を指定する第二引数thisArgも利用できます。このメソッドは、特定の条件を満たす要素が配列内に一つでも存在するかどうかを簡潔に確認したい場合に非常に役立ち、例えば、数値の配列に特定のしきい値を超える値が含まれているか、文字列の配列に特定のキーワードが含まれているかなどを効率的に判定できます。空の配列に対してsome()メソッドを実行した場合、コールバック関数は一度も実行されず、常に偽を返します。
構文(syntax)
1const array = [10, 20, 30]; 2const existsGreaterThan25 = array.some((element, index, arr) => { 3 return element > 25; 4});
引数(parameters)
callbackFn, thisArg
- callbackFn: Array の各要素に対して実行されるコールバック関数。この関数が true を返すと、some() メソッドは true を返します。
- thisArg: callbackFn を実行する際に、this として使用される値。
戻り値(return)
boolean
指定された条件に合致する配列の要素が一つでも存在するかどうかを示す真偽値(boolean)を返します。