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 September 2016.

Die [Symbol.iterator]() Methode von Iterator Instanzen implementiert das iterable protocol und ermöglicht es, dass eingebaute Iteratoren von den meisten Syntaxen, die Iterables erwarten, konsumiert werden können, wie z.B. die Spread-Syntax und for...of Schleifen. 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 der for...of Schleife

Beachten Sie, dass Sie diese Methode selten direkt aufrufen müssen. Die Existenz der [Symbol.iterator]() Methode macht eingebaute Iteratoren zu iterables, und iterierende Syntaxen wie die for...of Schleife rufen automatisch diese Methode auf, um den Iterator zum Durchlaufen zu erhalten.

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

Spezifikationen

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

Browser-Kompatibilität

Siehe auch