Array.prototype.includes()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2016.
Die includes()
-Methode von Array
-Instanzen bestimmt, ob ein Array einen bestimmten Wert unter seinen Einträgen enthält und gibt entsprechend true
oder false
zurück.
Probieren Sie es aus
const array1 = [1, 2, 3];
console.log(array1.includes(2));
// Expected output: true
const pets = ["cat", "dog", "bat"];
console.log(pets.includes("cat"));
// Expected output: true
console.log(pets.includes("at"));
// Expected output: false
Syntax
includes(searchElement)
includes(searchElement, fromIndex)
Parameter
searchElement
-
Der zu suchende Wert.
fromIndex
Optional-
Nullbasierter Index, ab dem die Suche gestartet wird, konvertiert zu einer Ganzzahl.
- Ein negativer Index zählt vom Ende des Arrays zurück — wenn
-array.length <= fromIndex < 0
, wirdfromIndex + array.length
verwendet. Das Array wird jedoch trotzdem von vorne nach hinten durchsucht. - Wenn
fromIndex < -array.length
ist oderfromIndex
weggelassen wird, wird0
verwendet, wodurch das gesamte Array durchsucht wird. - Wenn
fromIndex >= array.length
, wird das Array nicht durchsucht undfalse
zurückgegeben.
- Ein negativer Index zählt vom Ende des Arrays zurück — wenn
Rückgabewert
Ein Boolean-Wert, der true
ist, wenn der Wert searchElement
im Array (oder im durch den Index fromIndex
, falls angegeben, festgelegten Teil des Arrays) gefunden wird.
Beschreibung
Die Methode includes()
vergleicht searchElement
mit den Elementen des Arrays mithilfe des SameValueZero-Algorithmus. Werte von Null werden unabhängig vom Vorzeichen als gleich betrachtet (d. h., -0
ist gleich 0
), aber false
wird nicht als dasselbe wie 0
betrachtet. NaN
kann korrekt gesucht werden.
Bei Verwendung mit lückenhaften Arrays iteriert die Methode includes()
leere Slots, als ob sie den Wert undefined
hätten.
Die Methode includes()
ist generisch. Sie erwartet lediglich, dass der this
-Wert eine length
-Eigenschaft und Integer-Keys als Eigenschaften hat.
Beispiele
Verwendung von includes()
[1, 2, 3].includes(2); // true
[1, 2, 3].includes(4); // false
[1, 2, 3].includes(3, 3); // false
[1, 2, 3].includes(3, -1); // true
[1, 2, NaN].includes(NaN); // true
["1", "2", "3"].includes(3); // false
Wenn fromIndex größer oder gleich der Array-Länge ist
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
Berechneter Index ist kleiner als 0
Wenn fromIndex
negativ ist, wird der berechnete Index als Position im Array verwendet, 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
Verwendung von includes() bei lückenhaften Arrays
Sie können in einem lückenhaften Array nach undefined
suchen und erhalten true
.
console.log([1, , 3].includes(undefined)); // true
Aufruf von includes() auf Nicht-Array-Objekten
Die Methode includes()
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
Spezifikationen
Specification |
---|
ECMAScript® 2025 Language Specification # sec-array.prototype.includes |
Browser-Kompatibilität
Report problems with this compatibility data on GitHubdesktop | mobile | server | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
includes |
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support