AsyncIterator.prototype[Symbol.asyncIterator]()
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Januar 2020 browserübergreifend verfügbar.
Die [Symbol.asyncIterator]()-Methode von AsyncIterator-Instanzen implementiert das asynchrone Iterable-Protokoll und ermöglicht es, dass eingebaute asynchrone Iteratoren von den meisten Syntaxen konsumiert werden können, die asynchrone Iterables erwarten, wie z.B. for await...of-Schleifen. Sie gibt den Wert von this zurück, was das asynchrone Iterator-Objekt selbst ist.
Syntax
asyncIterator[Symbol.asyncIterator]()
Parameter
Keine.
Rückgabewert
Der Wert von this, was das asynchrone Iterator-Objekt selbst ist.
Beispiele
Iteration mit der for await...of-Schleife
Beachten Sie, dass Sie diese Methode selten direkt aufrufen müssen. Die Existenz der [Symbol.asyncIterator]()-Methode macht alle eingebauten asynchronen Iteratoren asynchron iterabel, und iterierende Syntaxen wie die for await...of-Schleife rufen diese Methode automatisch auf, um den asynchronen Iterator zu erhalten, über den iteriert wird.
const asyncIterator = (async function* () {
yield 1;
yield 2;
yield 3;
})();
(async () => {
for await (const value of asyncIterator) {
console.log(value);
}
})();
// Logs: 1, 2, 3
Spezifikationen
| Spezifikation |
|---|
| ECMAScript® 2026 Language Specification # sec-asynciteratorprototype-asynciterator |