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 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

js
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.

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

Browser-Kompatibilität

Siehe auch