AsyncIterator.prototype[Symbol.asyncIterator]()

Baseline Widely available

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

Die [Symbol.asyncIterator]() Methode von AsyncIterator Instanzen implementiert das asynchrone Iterationsprotokoll und ermöglicht es, eingebaute asynchrone Iteratoren mit den meisten Syntaxen zu konsumieren, die asynchrone Iterable erwarten, wie zum Beispiel for await...of Schleifen. Sie gibt den Wert von this zurück, was das asynchrone Iteratorobjekt selbst ist.

Syntax

js
asyncIterator[Symbol.asyncIterator]()

Parameter

Keine.

Rückgabewert

Der Wert von this, welches das asynchrone Iteratorobjekt selbst ist.

Beispiele

Iteration mittels for await...of Schleife

Beachten Sie, dass Sie diese Methode selten direkt aufrufen müssen. Die Existenz der Methode [Symbol.asyncIterator]() macht alle eingebauten asynchronen Iteratoren asynchron iterierbar, und Iterations-Syntaxen wie die for await...of Schleife rufen diese Methode automatisch auf, um den asynchronen Iterator zu erhalten, über den iteriert wird.

js
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

Specification
ECMAScript® 2025 Language Specification
# sec-asynciteratorprototype-asynciterator

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
[Symbol.asyncIterator]

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

Siehe auch