AsyncGenerator.prototype.throw()

exception

Die auszulösende Ausnahme. Zu Debugging-Zwecken ist es nützlich, sie zu einem instanceof von Error zu machen.

Wenn der ausgelöste Fehler nicht abgefangen wird, wird ein Promise zurückgegeben, das mit der übergebenen Ausnahme abgelehnt wird.

Wenn die Ausnahme durch einen try...catch Block abgefangen wird und der Generator fortfährt, um weitere Werte zu liefern, wird ein Promise zurückgegeben, das mit einem Object aufgelöst wird, welches zwei Eigenschaften enthält:

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 aus dem nächsten yield-Ausdruck hervorgeht.

Das folgende Beispiel zeigt einen einfachen Generator und einen Fehler, der mit der throw-Methode ausgelöst wird. Ein Fehler kann wie üblich 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 }

• async function*
• Iterators und Generators Leitfaden