Iterator.prototype[Symbol.iterator]()
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit September 2016 browserübergreifend verfügbar.
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
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.
const arrIterator = [1, 2, 3].values();
for (const value of arrIterator) {
console.log(value);
}
// Logs: 1, 2, 3
Spezifikationen
| Spezifikation |
|---|
| ECMAScript® 2026 Language Specification # sec-%iteratorprototype%-%symbol.iterator% |