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 Methode [Symbol.asyncIterator]() von AsyncIterator-Instanzen implementiert das Asynchrones Iterable-Protokoll und ermöglicht es, eingebaute asynchrone Iteratoren mit den meisten Syntaxen zu verwenden, die asynchrone Iterables erwarten, wie beispielsweise Schleifen vom Typ for await...of. Sie gibt den Wert von this zurück, welches das asynchrone Iterator-Objekt selbst ist.

Probieren Sie es aus

Syntax

js
asyncIterator[Symbol.asyncIterator]()

Parameter

Keine.

Rückgabewert

Der Wert von this, welches das asynchrone Iterator-Objekt selbst ist.

Beispiele

Iteration mit einer 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 zu asynchronen Iterables, und Syntaxen zur Iteration wie die for await...of-Schleife rufen diese Methode automatisch auf, um den asynchronen Iterator zum Durchlaufen zu erhalten.

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 Language Specification
# sec-asynciteratorprototype-asynciterator

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch