WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Array.prototype.includes: Vorhandensein eines Werts prüfen

includes liefert einen Boolean, ob ein Array-Bereich einen Wert nach SameValueZero enthält.

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

Syntax

array.includes(searchElement[, fromIndex])

array.includes(searchElement[, fromIndex]) sucht ab fromIndex und liefert beim ersten SameValueZero-Treffer true. Daher ist NaN gleich NaN und +0 gleich -0. Die Methode liefert nur einen Boolean, keinen Index.

fromIndex wird zur Ganzzahl abgeschnitten; ein negativer Index zählt vom Ende, ein zu kleiner beginnt bei null, Infinity liefert false. Lücken werden als undefined gelesen und können treffen. Die Methode ist für array-ähnliche Empfänger generisch und mutiert nicht; null/undefined löst TypeError aus. Das Beispiel zeigt NaN, eine Lücke und einen eingeschränkten Start.

Beispiele

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

Ergebnis

true
true
true
false

Quellen