CKTIS / JavaScript
Array.prototype.includes: testar a presença de um valor
includes devolve um booleano que indica se um intervalo contém um valor segundo SameValueZero.
Versão: ECMAScript 2026 draft; example target: Node.js 24.22.2
Sintaxe
array.includes(searchElement[, fromIndex])array.includes(searchElement[, fromIndex]) procura desde fromIndex e devolve true na primeira correspondência SameValueZero. Assim NaN é igual a NaN e +0 a -0. Devolve apenas um booleano, não um índice.
fromIndex é truncado para inteiro; um índice negativo conta do fim, um demasiado negativo começa em zero e Infinity dá false. Posições vazias são lidas como undefined e podem corresponder. É genérico para recetores array-like e não altera; null/undefined lança TypeError. O exemplo cobre NaN, uma posição vazia e um início limitado.
Exemplos
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