Array.prototype.findLastIndex()

試してみましょう

const array = [5, 12, 50, 130, 44];

const isLargeNumber = (element) => element > 45;

console.log(array.findLastIndex(isLargeNumber));
// 予想される結果: 3
// Index of element with value: 130

構文

findLastIndex(callbackFn)
findLastIndex(callbackFn, thisArg)

引数

callbackFn

配列のそれぞれの要素に対して実行する関数です。一致する要素が得られたことを示すには真値を返し、そうでなければ偽値を返してください。この関数は以下の引数で呼び出されます。

element

配列内で現在処理されている要素です。

index

配列内で現在処理されている要素のインデックス（位置）です。

array

findLastIndex() を呼び出した元の配列です。

thisArg 省略可

callbackFn 内で this として使われるオブジェクトです。反復処理メソッドを参照してください。

返値

配列内で、テストを満たした最後の（最も大きな）要素のインデックス。 それ以外の場合は，一致する要素が見つからなければ -1 となります。

解説

findLastIndex() メソッドは反復処理メソッドです。配列のそれぞれの要素に対して、インデックスの降順に一度ずつ指定された callbackFn 関数を実行し、 callbackFn が真値を返すまで続けます。そして、 findLastIndex() がその要素のインデックスを返し、配列のイテレーターを停止します。もし callbackFn が真値を返さなかった場合、 findLastIndex() は -1 を返します。これらのメソッドが一般的にどのように動作するのかについての詳細は、反復処理メソッドの節をご覧ください。

callbackFn は、値が割り当てられているものに限らず、配列中のすべてのインデックスに対して呼び出されます。疎配列では、空のスロットは undefined と同じ動作をします。

findLastIndex() メソッドは汎用的です。これは this 値に length プロパティと整数キーのプロパティがあることだけを期待します。

例

配列内の最後の素数の位置を探す

以下の例では、配列の最後の要素が素数である場合のインデックスを返します。素数が存在しない場合は -1 を返します。

function isPrime(n) {
  if (n < 2) {
    return false;
  }
  if (n % 2 === 0) {
    return n === 2;
  }
  for (let factor = 3; factor * factor <= n; factor += 2) {
    if (n % factor === 0) {
      return false;
    }
  }
  return true;
}

console.log([4, 6, 8, 12].findLastIndex(isPrime)); // -1, not found
console.log([4, 5, 7, 8, 9, 11, 12].findLastIndex(isPrime)); // 5

callbackFn の第 3 引数の使用

array 引数は、配列内の別の要素にアクセスする場合、特に、その配列を参照する既存の変数がない場合に便利です。次の例では、最初に filter() を使用して正の値を抽出し、次に findLastIndex() を使用して、その隣よりも小さい最後の要素を探します。

const numbers = [3, -1, 1, 4, 1, 5, 9, 2, 6];
const lastTrough = numbers
  .filter((num) => num > 0)
  .findLastIndex((num, idx, arr) => {
    // arr 引数がない場合、変数に保存せずに中間配列に簡単に
    // アクセスする方法はありません。
    if (idx > 0 && num >= arr[idx - 1]) return false;
    if (idx < arr.length - 1 && num >= arr[idx + 1]) return false;
    return true;
  });
console.log(lastTrough); // 6

疎配列に対する findLastIndex() の使用

疎配列から undefined を検索し、空のスロットのインデックスを取得することができます。

console.log([1, , 3].findLastIndex((x) => x === undefined)); // 1

配列でないオブジェクトに対する findLastIndex() の呼び出し

findLastIndex() メソッドは this の length プロパティを読み込み、次にキーが length より小さい非負の整数である各プロパティにアクセスします。

const arrayLike = {
  length: 3,
  0: 2,
  1: 7.3,
  2: 4,
  3: 3, // length が 3 であるため findLastIndex() から無視される
};
console.log(
  Array.prototype.findLastIndex.call(arrayLike, (x) => Number.isInteger(x)),
); // 2

仕様書

ブラウザーの互換性

関連情報

• Array.prototype.findLastIndex のポリフィル (core-js)
• es-shims による Array.prototype.findLastIndex のポリフィル
• インデックス付きコレクションのガイド
• Array
• Array.prototype.find()
• Array.prototype.findIndex()
• Array.prototype.findLast()
• Array.prototype.indexOf()
• Array.prototype.lastIndexOf()
• TypedArray.prototype.findLastIndex()