Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Array.prototype.indexOf: indeks pierwszego ścisłego dopasowania

indexOf zwraca pierwszy indeks elementu równego przez === albo -1, gdy elementu nie ma.

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

Składnia

array.indexOf(searchElement[, fromIndex])

array.indexOf(searchElement[, fromIndex]) przeszukuje rosnąco od fromIndex, używa ścisłego porównania === i zwraca indeks pierwszego dopasowania. Brak dopasowania daje -1. W odróżnieniu od includes, NaN nigdy nie pasuje do NaN, natomiast +0 i -0 są równe.

fromIndex jest obcinany do liczby całkowitej; wartość ujemna liczy od końca, zbyt mała zaczyna od zera, a Infinity od razu daje -1. Dziury są pomijane, więc nie stanowią dopasowania dla undefined. Metoda jest generyczna dla array-like i nie mutuje odbiorcy; null/undefined powoduje TypeError. Przykład zestawia duplikat, NaN, dziurę i indeks startowy.

Przykłady

const values = [NaN, , "x", "x"];
console.log(values.indexOf("x"));
console.log(values.indexOf("x", 3));
console.log(values.indexOf(NaN));
console.log(values.indexOf(undefined));

Wynik

2
3
-1
-1

Źródła