CKTIS / JavaScript
Array.prototype.includes: aanwezigheid van een waarde toetsen
includes retourneert een boolean die aangeeft of een arraybereik een waarde bevat volgens SameValueZero.
Versie: ECMAScript 2026 draft; example target: Node.js 24.22.2
Syntax
array.includes(searchElement[, fromIndex])array.includes(searchElement[, fromIndex]) zoekt vanaf fromIndex en retourneert true bij de eerste SameValueZero-treffer. Daardoor is NaN gelijk aan NaN en +0 aan -0. De methode retourneert alleen een boolean, geen index.
fromIndex wordt geheel afgekapt; een negatieve index telt vanaf het einde, een te kleine start bij nul en Infinity geeft false. Gaten worden als undefined gelezen en kunnen dus passen. De methode is generiek voor array-achtige ontvangers en muteert niet; null/undefined werpt TypeError. Het voorbeeld toont NaN, een gat en een beperkte start.
Voorbeelden
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));Resultaat
true true true false