Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

Array.prototype.includes: comprobar la presencia de un valor

includes devuelve un booleano que indica si un rango del array contiene un valor según SameValueZero.

Versión: ECMAScript 2026 draft; example target: Node.js 24.22.2

Sintaxis

array.includes(searchElement[, fromIndex])

array.includes(searchElement[, fromIndex]) busca desde fromIndex y devuelve true con la primera coincidencia SameValueZero. Así NaN equivale a NaN y +0 a -0. Solo devuelve un booleano, no un índice.

fromIndex se trunca a entero; uno negativo cuenta desde el final, uno demasiado negativo empieza en cero e Infinity produce false. Los huecos se leen como undefined y pueden coincidir. Es genérico para receptores array-like y no los muta; null/undefined lanza TypeError. El ejemplo cubre NaN, un hueco y un inicio restringido.

Ejemplos

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

Resultado

true
true
true
false

Fuentes