AsyncGenerator

Konstruktor

Es gibt keine JavaScript-Entitt, die dem AsyncGenerator-Konstruktor entspricht. Instanzen von AsyncGenerator mssen von async generator functions zurckgegeben werden:

async function* createAsyncGenerator() {
  yield Promise.resolve(1);
  yield await Promise.resolve(2);
  yield 3;
}
const asyncGen = createAsyncGenerator();
asyncGen.next().then((res) => console.log(res.value)); // 1
asyncGen.next().then((res) => console.log(res.value)); // 2
asyncGen.next().then((res) => console.log(res.value)); // 3

Es gibt nur ein verstecktes Objekt, das das Prototyp-Objekt ist, das von allen Objekten geteilt wird, die von async generator functions erstellt werden. Dieses Objekt wird oft als AsyncGenerator.prototype stilisiert, um es wie eine Klasse aussehen zu lassen, aber es sollte angemessener AsyncGeneratorFunction.prototype.prototype genannt werden, da AsyncGeneratorFunction eine tatschliche JavaScript-Entitt ist. Um die Prototypen-Kette von AsyncGenerator-Instanzen zu verstehen, siehe AsyncGeneratorFunction.prototype.prototype.

Instanz-Eigenschaften

Diese Eigenschaften sind auf AsyncGenerator.prototype definiert und werden von allen AsyncGenerator-Instanzen geteilt.

AsyncGenerator.prototype.constructor

Die Konstruktorfunktion, die das Instanzobjekt erstellt hat. Fr AsyncGenerator-Instanzen ist der Anfangswert AsyncGeneratorFunction.prototype.

Hinweis: AsyncGenerator-Objekte speichern keinen Verweis auf die async generator function, die sie erstellt hat.

AsyncGenerator.prototype[Symbol.toStringTag]

Der Anfangswert der [Symbol.toStringTag]-Eigenschaft ist der String "AsyncGenerator". Diese Eigenschaft wird in Object.prototype.toString() verwendet.

Instanz-Methoden

Erbt ebenfalls Instanz-Methoden von seinem Elternteil AsyncIterator.

AsyncGenerator.prototype.next()

Gibt ein Promise zurck, das mit dem angegebenen Wert aufgelst wird, der durch den yield-Ausdruck geliefert wird.

AsyncGenerator.prototype.return()

Verhlt sich so, als ob ein return-Statement im Krper des Generators an der aktuellen angehaltenen Position eingefgt wird, was den Generator beendet und es dem Generator ermglicht, alle Aufrumaufgaben auszufhren, wenn es mit einem try...finally-Block kombiniert wird.

AsyncGenerator.prototype.throw()

Verhlt sich so, als ob ein throw-Statement im Krper des Generators an der aktuellen angehaltenen Position eingefgt wird, was den Generator ber einen Fehlerzustand informiert und es ihm ermglicht, den Fehler zu behandeln, oder Aufrumarbeiten durchzufhren und sich selbst zu schlieen.

Beispiele

Async-Generator-Iteration

Das folgende Beispiel iteriert ber einen async generator, der die Werte 16 in der Konsole bei abnehmenden Zeitintervallen protokolliert. Beachten Sie, wie jedes Mal ein Promise geliefert wird, das aber automatisch innerhalb der for await...of-Schleife aufgelst wird.

// An async task. Pretend it's doing something more useful
// in practice.
function delayedValue(time, value) {
  return new Promise((resolve /*, reject */) => {
    setTimeout(() => resolve(value), time);
  });
}

async function* generate() {
  yield delayedValue(2000, 1);
  yield delayedValue(1000, 2);
  yield delayedValue(500, 3);
  yield delayedValue(250, 4);
  yield delayedValue(125, 5);
  yield delayedValue(50, 6);
  console.log("All done!");
}

async function main() {
  for await (const value of generate()) {
    console.log("value", value);
  }
}

main().catch((e) => console.error(e));

Spezifikationen

Browser-Kompatibilitt

Siehe auch

• function*
• async function*
• function* Ausdruck
• Generator Function
• Async Generator Function
• Iteratoren und Generatoren Leitfaden