Array.prototype.includes()

searchElement

Der zu suchende Wert.

fromIndex Optional

Nullbasierter Index, ab dem mit der Suche begonnen wird, in einen Integer umgewandelt.

• Ein negativer Index zählt vom Ende des Arrays rückwärts — wenn -array.length <= fromIndex < 0, wird fromIndex + array.length verwendet. Das Array wird jedoch immer noch von vorne nach hinten durchsucht.
• Ist fromIndex < -array.length oder wird fromIndex weggelassen, wird 0 verwendet, sodass das gesamte Array durchsucht wird.
• Ist fromIndex >= array.length, wird das Array nicht durchsucht und es wird false zurückgegeben.

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

Die includes()-Methode vergleicht searchElement mit den Elementen des Arrays unter Verwendung des SameValueZero-Algorithmus. Werte von Null werden unabhängig von ihrem Vorzeichen als gleich betrachtet (d.h. -0 ist gleich 0), aber false wird nicht als gleich 0 angesehen. NaN kann korrekt gesucht werden.

Wenn sie auf dünn besetzten Arrays angewendet wird, iteriert die includes()-Methode leere Slots, als ob sie den Wert undefined hätten.

Die includes()-Methode ist generisch. Sie erwartet nur, dass der this-Wert eine length-Eigenschaft und Integer-indizierte Eigenschaften hat.

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 verwendet, um die Position im Array zu ermitteln, an der die Suche nach searchElement beginnt. Ist der berechnete Index kleiner oder gleich 0, 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 dünn besetzten Array suchen und true zurückbekommen.

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 ganze Zahl ist, die 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
• Leitfaden zu indizierten Sammlungen
• Array
• Array.prototype.indexOf()
• Array.prototype.find()
• Array.prototype.findIndex()
• TypedArray.prototype.includes()
• String.prototype.includes()