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