Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

Array.prototype.includes: test prítomnosti hodnoty

includes vracia boolean, či rozsah poľa obsahuje hodnotu podľa porovnania SameValueZero.

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

Syntax

array.includes(searchElement[, fromIndex])

array.includes(searchElement[, fromIndex]) hľadá od fromIndex a pri prvej zhode SameValueZero vráti true. Preto sa NaN rovná NaN a +0 sa rovná -0. Metóda vracia iba boolean, nie index.

fromIndex sa oreže na celé číslo; záporný index počíta od konca, príliš záporný začína na nule a Infinity dáva false. Diery sa čítajú ako undefined a môžu zodpovedať. Metóda je všeobecná pre array-like prijímateľov a nemení ich; null/undefined vyvolá TypeError. Príklad ukazuje NaN, dieru a obmedzený začiatok.

Prí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ýsledok

true
true
true
false

Zdroje