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

findLastIndexメソッドは、配列の要素を後ろから前に向かって探索し、指定されたテスト関数が真を返す最初の要素のインデックスを返すメソッドです。このメソッドは、Array.prototypeに属しており、Node.jsを含むJavaScript環境で利用できます。

このメソッドは引数としてcallbackFnという関数を受け取ります。callbackFnは配列の各要素に対して一度ずつ実行され、その要素が条件を満たすかどうかを判断するための真偽値を返します。callbackFnは、現在処理中の要素、その要素のインデックス、そしてfindLastIndexが呼び出された元の配列という3つの引数を受け取ることができます。

findLastIndexメソッドは、配列の最後の要素から先頭に向かって順にcallbackFnを実行していきます。もしcallbackFnがtrueを返した場合、その時点の要素のインデックスがこのメソッドの戻り値となります。条件を満たす要素が一度見つかると、それ以上の探索は行われずに処理は終了します。

もし配列のすべての要素に対してcallbackFnがfalseを返し、条件を満たす要素が一つも見つからなかった場合、このメソッドは-1を返します。これは、目的の要素が配列内に存在しなかったことを示します。

このメソッドは、配列内で特定の条件を満たす最後の項目がどこにあるかを知りたい場合に特に役立ちます。例えば、特定の状態にある最後のオブジェクトのインデックスを探す際などに利用できます。この操作は元の配列自体を変更することなく、非破壊的に行われます。

Copy
1const array = [10, 20, 30, 15, 25];
2const foundIndex = array.findLastIndex((element, index, arr) => element > 20);
3// foundIndex は 4 (値 25 のインデックス)

predicate, thisArg

• predicate: (element, index, array) => boolean: 要素、インデックス、配列を引数に取り、要素が条件に一致するかどうかを真偽値で返す関数。
• thisArg: any: predicate関数が実行される際のthisとして使用される値。

number

指定された条件に一致する要素が配列内に見つかった場合、その要素のインデックス（位置）を返します。見つからなかった場合は -1 を返します。