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 asynchrone Iterierprotokoll und ermöglicht es, eingebaute asynchrone Iteratoren mit den meisten auf asynchrone Iterierbare ausgelegten Syntaxen zu verwenden, wie zum Beispiel for await...of-Schleifen. Sie gibt den Wert von this zurück, welcher das asynchrone Iterator-Objekt selbst ist.

Syntax

js
asyncIterator[Symbol.asyncIterator]()

Parameter

Keine.

Rückgabewert

Der Wert von this, welches 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 ermöglicht es, dass alle eingebauten asynchronen Iteratoren asynchron iterierbar sind, und Iterations-Syntaxen wie die for await...of-Schleife rufen automatisch diese Methode auf, um den asynchronen Iterator zu erhalten, über den iteriert werden soll.

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