Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Array.prototype.findLastIndex: indeks ostatniego dopasowania

findLastIndex przeszukuje od końca i zwraca indeks pierwszego dopasowania w tym kierunku albo -1.

Wersja: ECMAScript 2026 draft; example target: Node.js 24.22.2

Składnia

array.findLastIndex(callbackFn[, thisArg])

array.findLastIndex(callbackFn[, thisArg]) zaczyna od length - 1, wywołuje callbackFn(value, index, array) malejąco i zwraca indeks całkowity przy pierwszym wyniku truthy. Gdy nic nie pasuje, zwraca -1; nie zwraca wartości elementu. To jednoznacznie odróżnia brak dopasowania od znalezionego undefined.

Długość jest zapamiętywana na początku. Każdy indeks w zakresie jest odwiedzany, a dziura odczytywana jako undefined. Zmiana niższego indeksu przed wizytą jest widoczna, lecz elementy dopisane poza początkową długością nie są badane. Callback niebędący funkcją lub odbiorca null/undefined powoduje TypeError; wyjątek callbacku przerywa wyszukiwanie. Przykład zwraca ostatni indeks duplikatu i pokazuje -1.

Przykłady

const values = [4, 7, 4, 9, 4];
console.log(values.findLastIndex(value => value === 4));
console.log(values.findLastIndex(value => value === 10));

Wynik

4
-1

Źródła