KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

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

Bronnen