Iterator.prototype[Symbol.iterator]()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Die Methode [Symbol.iterator]() von Iterator Instanzen implementiert das iterable Protokoll und ermöglicht es, dass eingebaute Iteratoren durch die meisten Syntaxen, die Iterables erwarten, wie der Spread-Syntax und for...of Schleifen, konsumiert werden. Sie gibt den Wert von this zurück, welches das Iterator-Objekt selbst ist.

Syntax

js
iterator[Symbol.iterator]()

Parameter

Keine.

Rückgabewert

Der Wert von this, welches das Iterator-Objekt selbst ist.

Beispiele

Iteration mit for...of Schleife

Beachten Sie, dass diese Methode selten direkt aufgerufen werden muss. Die Existenz der [Symbol.iterator]()-Methode macht eingebaute Iteratoren iterable, und iterierende Syntaxen wie die for...of Schleife rufen diese Methode automatisch auf, um den Iterator zu erhalten, über den iteriert werden soll.

js
const arrIterator = [1, 2, 3].values();
for (const value of arrIterator) {
  console.log(value);
}
// Logs: 1, 2, 3

Spezifikationen

Specification
ECMAScript Language Specification
# sec-%iteratorprototype%-%symbol.iterator%

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch