Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Array.prototype.includes: verificare la presenza di un valore

includes restituisce un booleano che indica se un intervallo contiene un valore secondo SameValueZero.

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

Sintassi

array.includes(searchElement[, fromIndex])

array.includes(searchElement[, fromIndex]) cerca da fromIndex e restituisce true alla prima corrispondenza SameValueZero. Quindi NaN equivale a NaN e +0 a -0. Restituisce solo un booleano, non un indice.

fromIndex è troncato a intero; un indice negativo conta dalla fine, uno troppo negativo parte da zero e Infinity produce false. I vuoti sono letti come undefined e possono corrispondere. È generico per riceventi array-like e non muta; null/undefined genera TypeError. L’esempio copre NaN, un vuoto e un punto iniziale limitato.

Esempi

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

Risultato

true
true
true
false

Fonti