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