【Node.js24.x】Array::some()メソッドの使い方

someメソッドは、配列内に指定された条件を満たす要素が少なくとも一つ存在するかどうかを確認するメソッドです。

このメソッドは、配列の各要素に対して、引数として渡されるテスト関数（コールバック関数）を一度ずつ実行します。テスト関数がtrueを返した最初の要素が見つかった時点で、someメソッドはただちにtrueを返して処理を終了します。これは、残りの要素をチェックする必要がないため、効率的な処理を実現します。もし、配列のすべての要素に対してテスト関数が実行され、一度もtrueを返さなかった場合は、someメソッドは最終的にfalseを返します。

テスト関数は、現在の配列要素、そのインデックス、そして呼び出された配列自身を引数として受け取ることができます。someメソッドは元の配列を変更せず、新しい配列も生成しません。

このメソッドの主な用途は、例えばオンラインストアの注文に在庫切れの商品が一つでも含まれているかを確認するなど、配列内に特定の条件に合致するデータが一つでも含まれているかを効率的にチェックしたい場合に非常に役立ちます。

Copy
1const dataArray = [1, 2, 3];
2const conditionMet = dataArray.some((currentElement, elementIndex, originalArray) => {
3  return currentElement > 2;
4});

callbackFn, thisArg

• callbackFn: (element: any, index: number, array: any[]) => boolean: 配列の各要素に対して実行されるコールバック関数。要素が条件を満たす場合はtrue、満たさない場合はfalseを返します。
• thisArg: any: callbackFn が実行される際に、this として使用される値。

boolean

配列のいずれかの要素が、指定されたテスト関数を満たす場合にtrueを返します。すべての要素がテスト関数を満たさない場合はfalseを返します。