AsyncGenerator.prototype.throw()

Syntax

asyncGeneratorInstance.throw(exception)

Parameter

exception

Die Ausnahme, die geworfen werden soll. Zu Debugging-Zwecken ist es ntzlich, sie als instanceof Error zu gestalten.

Rckgabewert

Falls der geworfene Fehler nicht abgefangen wird, wird ein Promise zurckgegeben, das mit der bergebenen Ausnahme abgelehnt wird.

Wird die Ausnahme von einem try...catch abgefangen und der Generator fhrt die Erzeugung weiterer Werte fort, wird ein Promise zurckgegeben, das mit einem Object aufgelst wird, das zwei Eigenschaften hat:

done

Ein boolescher Wert:

• true, wenn der Kontrollfluss der Generatorfunktion das Ende erreicht hat.
• false, wenn die Generatorfunktion in der Lage ist, weitere Werte zu erzeugen.

value

Der Wert, der vom nchsten yield-Ausdruck erzeugt wird.

Beispiele

Verwendung von throw()

Das folgende Beispiel zeigt einen Generator und einen Fehler, der mit der throw-Methode geworfen wird. Ein Fehler kann wie gewohnt von einem try...catch-Block abgefangen werden.

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

async function* createAsyncGenerator() {
  while (true) {
    try {
      await sleep(500);
      yield 42;
    } catch (e) {
      console.error(e);
    }
  }
}

const asyncGen = createAsyncGenerator();
asyncGen.next(1).then((res) => console.log(res)); // { value: 42, done: false }
asyncGen
  .throw(new Error("Something went wrong")) // Error: Something went wrong
  .then((res) => console.log(res)); // { value: 42, done: false }

Spezifikationen

Browser-Kompatibilitt

Siehe auch

• async function*
• Iteratoren und Generatoren Leitfaden