Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Array.prototype.findIndex: indeks pierwszego dopasowania

findIndex zwraca indeks pierwszego elementu z truthy callbackiem albo -1; odwiedza także dziury jako undefined.

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

Składnia

array.findIndex(callbackFn[, thisArg])

array.findIndex(callbackFn[, thisArg]) wywołuje callbackFn(value, index, array) rosnąco i po pierwszym wyniku truthy zwraca indeks całkowity. Nie zwraca wartości elementu. Brak dopasowania ma jednoznaczny wynik -1, dzięki czemu znalezione undefined nie jest problemem.

Długość jest ustalana na początku, ale każdy indeks w tym zakresie — również dziura odczytana jako undefined — jest odwiedzany. Zmiany przed wizytą są widoczne, dopisane dalsze indeksy nie. Callback niebędący funkcją lub odbiorca null lub undefined powoduje TypeError; wyjątek callbacku przerywa metodę. Przykład znajduje właśnie dziurę i osobno pokazuje -1.

Przykłady

const values = ["A", , "C"];
console.log(values.findIndex(value => value === undefined));
console.log(values.findIndex(value => value === "missing"));

Wynik

1
-1

Źródła