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

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch