Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Array.prototype.includes: sprawdzenie obecności wartości

includes zwraca boolean mówiący, czy zakres tablicy zawiera wartość według porównania SameValueZero.

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

Składnia

array.includes(searchElement[, fromIndex])

array.includes(searchElement[, fromIndex]) przeszukuje od fromIndex i zwraca true przy pierwszym porównaniu SameValueZero. Dzięki temu NaN jest równe NaN, a +0 i -0 są równe. Metoda zwraca wyłącznie boolean, nie indeks.

fromIndex jest obcinany do liczby całkowitej; indeks ujemny liczy od końca, zbyt mały zaczyna od zera, a Infinity daje false. Dziury są odczytywane jako undefined, więc mogą stanowić dopasowanie. Metoda jest generyczna dla array-like i nie mutuje odbiorcy; null/undefined powoduje TypeError. Przykład pokazuje NaN, dziurę oraz ograniczenie początku wyszukiwania.

Przykłady

const values = [NaN, , 0];
console.log(values.includes(NaN));
console.log(values.includes(undefined));
console.log(values.includes(0, -1));
console.log(values.includes(NaN, 1));

Wynik

true
true
true
false

Źródła