Baseline Widely available
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.
const array = [1, 2, 3];
console.log(array.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, in eine ganze Zahl umgewandelt.
-array.length <= fromIndex < 0
, wird fromIndex + array.length
verwendet. In diesem Fall wird das Array jedoch weiterhin von vorne nach hinten durchsucht.fromIndex < -array.length
ist oder fromIndex
weggelassen wird, wird 0
verwendet, wodurch das gesamte Array durchsucht wird.fromIndex >= array.length
ist, wird das Array nicht durchsucht und false
wird zurückgegeben.Ein Boolean-Wert, der true
ist, wenn der Wert searchElement
innerhalb des Arrays (oder dem durch den Index fromIndex
angegebenen Teil des Arrays, falls angegeben) gefunden wird.
Die includes()
Methode vergleicht searchElement
mit den Elementen des Arrays unter Verwendung des SameValueZero Algorithmus. Nullwerte 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 durchsucht werden.
Bei Verwendung auf sparsely besetzten Arrays iteriert die includes()
Methode leere Plätze, als hätten sie den Wert undefined
.
Die includes()
Methode ist generisch. Sie erwartet nur, dass der this
Wert eine length
Eigenschaft und integer-basierte Eigenschaften hat.
[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
fromIndex ist gröÃer oder gleich der Array-Länge
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 berechnet, um als Position im Array verwendet zu werden, an 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 sporadischen Arrays
Sie können nach undefined
in einem sporadischen Array suchen und true
erhalten.
console.log([1, , 3].includes(undefined)); // true
Nutzung von includes() bei Nicht-Array-Objekten
Die includes()
Methode liest die length
Eigenschaft von this
und greift dann auf jede Eigenschaft zu, deren Schlüssel eine nichtnegative ganze Zahl 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 Browser-Kompatibilität Siehe auch
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4