JavaScript Array includes()-Methode
JavaScript Array-ObjektBeispiel
Erkennen, ob das Arraysiteexample enthält:
let site = ['example', 'google', 'taobao'];
site.includes('example');
// true
site.includes('baidu');
// false
Selbst ausprobieren »
Definition und Verwendung
Die Methode includes() wird verwendet, um zu bestimmen, ob ein Array einen angegebenen Wert enthält. Wenn ja, gibt sie true zurück; andernfalls gibt sie false zurück.
[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
Browser-Unterstützung
Die Zahlen in der Tabelle geben die erste Browserversion an, die die Methode unterstützt.
| Methode | |||||
|---|---|---|---|---|---|
| includes() | 47 | 14 | 43 | 9 | 34 |
Syntax
arr.includes(searchElement) arr.includes(searchElement, fromIndex)
Parameterbeschreibung
| Parameter | Beschreibung |
|---|---|
| searchElement | Erforderlich. Der Elementwert, nach dem gesucht werden soll. |
| fromIndex | Optional. Der Index, an dem die Suche nach searchElement beginnt. Wenn er negativ ist, beginnt die Suche beim Index array.length + fromIndex in aufsteigender Reihenfolge. Standard ist 0. |
Technische Details
| Rückgabewert: | Boolescher Wert. Gibt true zurück, wenn der angegebene Wert gefunden wird, andernfalls false. |
|---|---|
| JavaScript-Version: | ECMAScript 6 |
Weitere Beispiele
fromIndex größer oder gleich der Array-Länge
Wenn fromIndex größer oder gleich der Array-Länge ist, wird false zurückgegeben. Das Array wird nicht durchsucht:
Beispiel
var arr = ['a', 'b', 'c'];
arr.includes('c', 3); //false
arr.includes('c', 100); // false
Berechneter Index kleiner als 0
Wenn fromIndex negativ ist, wird der berechnete Index als Position verwendet, an der die Suche nach searchElement beginnt. Wenn der berechnete Index kleiner als 0 ist, wird das gesamte Array durchsucht.
Beispiel
//Die Array-Länge ist 3
//fromIndex ist -100
//berechneter Index ist 3 + (-100) = -97
var arr = ['a', 'b', 'c'];
arr.includes('a', -100); // true
arr.includes('b', -100); // true
arr.includes('c', -100); // true