Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

Array.prototype.includes : tester la présence d’une valeur

includes renvoie un booléen indiquant si une plage du tableau contient une valeur selon SameValueZero.

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

Syntaxe

array.includes(searchElement[, fromIndex])

array.includes(searchElement[, fromIndex]) cherche depuis fromIndex et renvoie true à la première égalité SameValueZero. Ainsi NaN égale NaN et +0 égale -0. La méthode renvoie seulement un booléen, pas un indice.

fromIndex est tronqué en entier ; un indice négatif part de la fin, un indice trop petit repart de zéro et Infinity donne false. Les trous sont lus comme undefined et peuvent correspondre. La méthode est générique pour un receveur array-like et ne le modifie pas ; null/undefined lève TypeError. L’exemple couvre NaN, un trou et un départ limité.

Exemples

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

Résultat

true
true
true
false

Sources