Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

Array.prototype.includes: preverjanje prisotnosti vrednosti

includes vrne boolean, ali območje tabele vsebuje vrednost po primerjavi SameValueZero.

Različica: ECMAScript 2026 draft; example target: Node.js 24.22.2

Sintaksa

array.includes(searchElement[, fromIndex])

array.includes(searchElement[, fromIndex]) išče od fromIndex in ob prvem ujemanju SameValueZero vrne true. Zato je NaN enak NaN, +0 pa -0. Metoda vrne le boolean, ne indeksa.

fromIndex se odreže na celo število; negativni indeks šteje od konca, preveč negativni začne pri nič, Infinity pa da false. Prazna mesta se berejo kot undefined in se lahko ujemajo. Metoda je splošna za array-like prejemnike in jih ne spremeni; null/undefined sproži TypeError. Primer pokaže NaN, prazno mesto in omejen začetek.

Primeri

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));

Rezultat

true
true
true
false

Viri