TypedArray.prototype.findLastIndex()

callbackFn

型付き配列の要素に対するテストに使用する関数です。

この関数は以下の引数で呼び出されます。

element

型付き配列内で処理されている現在の要素。

index

型付き配列内で処理されている現在の要素の添字（位置）。

array

findLastIndex() が呼び出されている型付き配列。

コールバック関数は、適切な要素が見つかった際には真値を返す必要があります。 この要素の添字が findLastIndex() から返されます。

thisArg 省略可

オプション。 callbackFn を実行するときに this として使用する値。

テストに合格した要素のうち、配列の最後（最も大きな添字）の要素の添字。 一致する要素が見つからなかった場合に -1 を返します。

findLastIndex() メソッドは、callbackFn が真値を返すまで、型付き配列の各要素に対して、添字の降順に 1 回ずつ callbackFn 関数を実行します。 findLastIndex() はその要素の添字を返し、配列のイテレーターを反復処理するのを止めます。 もし callbackFn が真値を返さなかった場合、 findLastIndex() は undefined を返します。

callbackFn は、要素の値、要素の添字、走査されている型付き配列の 3 つの引数で呼び出されます。

thisArg 引数が findLastIndex() に指定された場合、それが callbackFn を呼び出すたびに this として使用されます。 指定されなかった場合は、undefinedが使用されます。

findLastIndex() メソッドは呼び出された型付き配列を変更しませんが、callbackFn に指定された関数からは変更することができます。

findLastIndex() が処理する要素の範囲は、callbackFn が最初に呼び出される前に設定されています。 findLastIndex() の呼び出しを始めた後に型付き配列に追加された要素は、callbackFn が処理する対象にはなりません。 型付き配列に存在する未処理の要素が callbackFn によって変更された場合、処理する callbackFn に渡されるその値は、findLastIndex() がその要素の要素を処理した時点の値になります。

以下の例では、配列の中で素数である最後の要素の添字を探します（素数がない場合は -1 を返します）。

function isPrime(element) {
  if (element % 2 === 0 || element < 2) {
    return false;
  }
  for (let factor = 3; factor <= Math.sqrt(element); factor += 2) {
    if (element % factor === 0) {
      return false;
    }
  }
  return true;
}

let uint8 = new Uint8Array([4, 6, 8, 12]);
console.log(uint8.findLastIndex(isPrime));
// -1 (no primes in array)
uint8 = new Uint8Array([4, 5, 7, 8, 9, 11, 12]);
console.log(uint8.findLastIndex(isPrime));
// 11

• TypedArray.prototype.findLastIndex のポリフィル (core-js)
• TypedArray.prototype.findLast()
• TypedArray.prototype.findIndex()
• TypedArray.prototype.indexOf()