Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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

Fontes