Array.prototype.includes()

searchElement

Der zu suchende Wert.

fromIndex Optional

Nullbasierter Index, ab dem die Suche startet, in eine Ganzzahl umgewandelt.

• Ein negativer Index zählt vom Ende des Arrays zurück — wenn -array.length <= fromIndex < 0, wird fromIndex + array.length verwendet. Das Array wird jedoch weiterhin von vorne nach hinten durchsucht.
• Wenn fromIndex < -array.length oder fromIndex weggelassen wird, wird 0 verwendet, wodurch das gesamte Array durchsucht wird.
• Wenn fromIndex >= array.length, wird das Array nicht durchsucht und false zurückgegeben.

Ein boolescher Wert, der true ist, wenn der Wert searchElement innerhalb des Arrays gefunden wird (oder dem durch den Index fromIndex angegebenen Teil des Arrays, falls angegeben).

Die includes()-Methode vergleicht searchElement mit Elementen des Arrays anhand des SameValueZero-Algorithmus. Werte von null werden unabhängig vom Vorzeichen als gleich betrachtet. (Das heißt, -0 ist gleich 0), aber false wird nicht als gleich 0 angesehen. NaN kann korrekt gesucht werden.

Bei der Verwendung auf spärlichen Arrays iteriert die includes()-Methode leere Stellen, als hätten sie den Wert undefined.

Die includes()-Methode ist generisch. Sie erwartet nur, dass der this-Wert eine length-Eigenschaft und integer-indexierte Eigenschaften besitzt.

Wenn fromIndex größer oder gleich der Länge des Arrays ist, wird false zurückgegeben. Das Array wird nicht durchsucht.

const arr = ["a", "b", "c"];

arr.includes("c", 3); // false
arr.includes("c", 100); // false

Wenn fromIndex negativ ist, wird der berechnete Index berechnet, um als Position im Array verwendet zu werden, ab der die Suche nach searchElement beginnt. Wenn der berechnete Index kleiner oder gleich 0 ist, wird das gesamte Array durchsucht.

// array length is 3
// fromIndex is -100
// computed index is 3 + (-100) = -97

const arr = ["a", "b", "c"];

arr.includes("a", -100); // true
arr.includes("b", -100); // true
arr.includes("c", -100); // true
arr.includes("a", -2); // false

Sie können undefined in einem spärlichen Array suchen und erhalten true.

console.log([1, , 3].includes(undefined)); // true

Die includes()-Methode liest die length-Eigenschaft von this und greift dann auf jede Eigenschaft zu, deren Schlüssel eine nicht negative Ganzzahl kleiner als length ist.

const arrayLike = {
  length: 3,
  0: 2,
  1: 3,
  2: 4,
  3: 1, // ignored by includes() since length is 3
};
console.log(Array.prototype.includes.call(arrayLike, 2));
// true
console.log(Array.prototype.includes.call(arrayLike, 1));
// false

• Polyfill von Array.prototype.includes in core-js
• es-shims Polyfill von Array.prototype.includes
• Indizierte Sammlungen Leitfaden
• Array
• Array.prototype.indexOf()
• Array.prototype.find()
• Array.prototype.findIndex()
• TypedArray.prototype.includes()
• String.prototype.includes()