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