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 iterierbare Protokoll und ermöglicht es, dass eingebaute Iteratoren von den meisten Syntaxen, die Iterables erwarten, verwendet werden, wie zum Beispiel 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 einer for...of-Schleife

Beachten Sie, dass Sie diese Methode selten direkt aufrufen müssen. Das Vorhandensein der [Symbol.iterator]()-Methode macht eingebaute Iteratoren iterierbar, und iterierende Syntaxen wie die for...of-Schleife rufen diese Methode automatisch auf, um den Iterator zu erhalten, über den sie iterieren können.

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