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

js
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, wird fromIndex + array.length verwendet. Das Array wird jedoch trotzdem von vorne nach hinten durchsucht.
  • Wenn fromIndex < -array.length ist 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.

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()

js
[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.

js
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.

js
// 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.

js
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.

js
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 GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
includes

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

Siehe auch