AsyncIterator

Baseline Weitgehend verfgbar *

Diese Funktion ist gut etabliert und funktioniert auf vielen Gerten und in vielen Browserversionen. Sie ist seit Januar 2020 browserbergreifend verfgbar.

* Einige Teile dieser Funktion werden mglicherweise unterschiedlich gut untersttzt.

Mehr erfahren
Vollstndige Kompatibilitt anzeigen

Ein AsyncIterator-Objekt ist ein Objekt, das dem async iterator protocol entspricht, indem es eine next()-Methode bereitstellt, die ein Promise zurckgibt, das ein Iterator-Resultat-Objekt erfllt. Das AsyncIterator.prototype-Objekt ist ein verstecktes globales Objekt, von dem alle eingebauten async Iteratoren erben. Es bietet eine [Symbol.asyncIterator]()-Methode, die das async Iterator-Objekt selbst zurckgibt und den async Iterator somit auch async iterable macht.

Beachten Sie, dass AsyncIterator kein globales Objekt ist, obwohl es dies in Zukunft mit dem async iterator helpers proposal sein wird. Das AsyncIterator.prototype-Objekt, das von allen eingebauten async Iteratoren geteilt wird, kann mit dem folgenden Code erhalten werden:

const AsyncIteratorPrototype = Object.getPrototypeOf(
  Object.getPrototypeOf(Object.getPrototypeOf((async function* () {})())),
);

Beschreibung

Derzeit ist der einzige eingebaute JavaScript async Iterator das AsyncGenerator-Objekt, das von async generator functions zurckgegeben wird. Es gibt einige andere eingebaute async Iteratoren in Web-APIs, wie z.B. einen ReadableStream.

Jeder dieser async Iteratoren hat ein eigenes Prototyp-Objekt, das die next()-Methode definiert, die vom jeweiligen async Iterator verwendet wird. Alle diese Prototyp-Objekte erben von AsyncIterator.prototype, das eine [Symbol.asyncIterator]()-Methode bietet, die das async Iterator-Objekt selbst zurckgibt und den async Iterator somit auch async iterable macht.

Hinweis: AsyncIterator.prototype implementiert nicht [Symbol.iterator](), sodass async Iteratoren standardmig nicht sync iterable sind.

Instanzmethoden

AsyncIterator.prototype[Symbol.asyncDispose](): Ruft die return()-Methode von this auf und wartet auf sie, falls sie existiert. Dies implementiert das async disposable protocol und ermglicht es, entsorgt zu werden, wenn es mit await using verwendet wird.
AsyncIterator.prototype[Symbol.asyncIterator](): Gibt das async Iterator-Objekt selbst zurck. Dadurch knnen async Iterator-Objekte auch async iterable sein.

Beispiele

Verwendung eines async Iterators als async iterable

Alle eingebauten async Iteratoren sind auch async iterable, sodass Sie sie in einer for await...of-Schleife verwenden knnen:

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

Spezifikation
ECMAScript 2027 LanguageSpecification # sec-asynciteratorprototype

Browser-Kompatibilitt

Siehe auch

Help improve MDN

War diese bersetzung hilfreich?

Ja Nein

Erfahren Sie, wie Sie beitragen knnen Diese Seite wurde automatisch aus dem Englischen bersetzt.

bersetzung auf GitHub anzeigen Fehler mit dieser bersetzung melden

Standard eingebaute Objekte
AsyncIterator
Instanzmethoden
1. [Symbol.asyncDispose]()
2. [Symbol.asyncIterator]()
Vererbung
Object/Function
Statische Methoden
Statische Eigenschaften
Instanzmethoden
Instanzeigenschaften
1. __proto__
2. constructor