Iterator.prototype.includes() - JavaScript | MDN

Seitenleiste umschalten

Farbschema

Systemeinstellung
Hell
Dunkel

Deutsch

Sprache merken Mehr erfahren

Iterator.prototype.includes()

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.

Die includes()-Methode von Iterator-Instanzen ist ähnlich wie Array.prototype.includes(): Sie gibt true zurück, wenn sie ein Element findet, das gleich dem angegebenen Wert ist. Andernfalls, wenn der Iterator ausgeschöpft wird, ohne ein solches Element zu finden, gibt er false zurück.

In diesem Artikel

Syntax

js
includes(searchElement)
includes(searchElement, fromIndex)

Parameter

searchElement

Der zu suchende Wert.

fromIndex Optional

Der nullbasierte Index, ab dem die Suche beginnt. Muss eine nicht-negative ganze Zahl, Infinity oder undefined sein. Wenn fromIndex größer oder gleich der Anzahl der vom Iterator erzeugten Elemente ist (einschließlich wenn fromIndex Infinity ist), gibt die Methode immer false zurück, nachdem der Iterator ausgeschöpft ist. Wenn fromIndex undefined ist, wird es standardmäßig auf 0 gesetzt.

Rückgabewert

Ein boolescher Wert, der true ist, wenn der Wert searchElement innerhalb des Iterators gefunden wird (oder dem Teil des Iterators ab fromIndex, falls angegeben).

Ausnahmen

TypeError

Wird ausgelöst, wenn fromIndex nicht eine der folgenden ist: eine ganze Zahl, Infinity, -Infinity oder undefined.

RangeError

Wird ausgelöst, wenn fromIndex negativ ist.

Beschreibung

Die includes()-Methode vergleicht searchElement mit Elementen des Arrays unter Verwendung des SameValueZero-Algorithmus. Dieser Algorithmus funktioniert wie die strikte Gleichheit === (wobei -0 und +0 als gleich angesehen werden), mit der Ausnahme, dass NaN als gleich zu sich selbst betrachtet wird.

Im Gegensatz zu Array.prototype.includes() darf der fromIndex-Parameter von Iterator.prototype.includes() nicht negativ sein, da der Iterator keine bekannte Länge hat. Die Typprüfung ist ebenfalls strenger: Nicht-Ganzzahlwerte werden nicht in ganze Zahlen umgewandelt.

Der Hauptvorteil von Iterator-Helfern gegenüber Array-Methoden besteht darin, dass sie faul sind, was bedeutet, dass sie den nächsten Wert nur bei Bedarf erzeugen. Dies vermeidet unnötige Berechnungen und ermöglicht auch die Verwendung mit unendlichen Iteratoren. Bei unendlichen Iteratoren gibt includes() true zurück, sobald das erste übereinstimmende Element gefunden wird. Wenn der Wert nie auftritt, gibt die Methode niemals zurück.

Der Aufruf von includes() schließt immer den zugrunde liegenden Iterator, selbst wenn die Methode frühzeitig zurückkehrt. Der Iterator bleibt niemals in einem halbwegs Zustand.

Beispiele

Verwendung von includes()

js
function* fibonacci() {
  let current = 1;
  let next = 1;
  while (true) {
    yield current;
    [current, next] = [next, current + next];
  }
}

console.log(fibonacci().includes(8)); // true
console.log(fibonacci().take(10).includes(7)); // false
console.log(fibonacci().includes(7)); // Never completes

Die Methode schließt den Iterator, nachdem sie zurückkehrt.

js
const seq = fibonacci();
console.log(seq.includes(8)); // true
console.log(seq.next()); // { value: undefined, done: true }

Verwendung von fromIndex

fromIndex gibt die Anzahl der Elemente an, die vom Anfang übersprungen werden. Es ist gleichbedeutend mit dem Aufruf von drop(fromIndex).includes(searchElement).

js
function* fibonacci() {
  let current = 1;
  let next = 1;
  while (true) {
    yield current;
    [current, next] = [next, current + next];
  }
}

console.log(fibonacci().includes(8, 3)); // true
console.log(fibonacci().includes(8, 10)); // false

Wenn fromIndex größer oder gleich den verfügbaren Elementen ist, wird false zurückgegeben.

["a", "b", "c"].values().includes("a", 3); // false

Help improve MDN

War diese Übersetzung hilfreich?

Ja Nein

Erfahren Sie, wie Sie beitragen können Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden

Standard eingebaute Objekte
Iterator
Konstruktor
1. Iterator()
Statische Methoden
Instanzmethoden
Vererbung
Object/Function
Statische Methoden
Statische Eigenschaften
Instanzmethoden
Instanzeigenschaften
1. __proto__
2. constructor