CKTIS / JavaScript
Array.prototype.includes: test přítomnosti hodnoty
includes vrací boolean, zda rozsah pole obsahuje hodnotu podle porovnání SameValueZero.
Verze: ECMAScript 2026 draft; example target: Node.js 24.22.2
Syntaxe
array.includes(searchElement[, fromIndex])array.includes(searchElement[, fromIndex]) hledá od fromIndex a při první shodě SameValueZero vrátí true. Proto se NaN rovná NaN a +0 se rovná -0. Metoda vrací jen boolean, nikoli index.
fromIndex se ořízne na celé číslo; záporný index počítá od konce, příliš záporný začíná na nule a Infinity dává false. Díry se čtou jako undefined a mohou odpovídat. Metoda je obecná pro array-like příjemce a nemění je; null/undefined vyvolá TypeError. Příklad ukazuje NaN, díru a omezený začátek.
Příklady
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));Výsledek
true true true false