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