Generator.prototype.throw()

Syntax

generatorInstance.throw(exception)

Parameter

exception

Die zu werfende Ausnahme. Fr Debugging-Zwecke ist es ntzlich, sie zu einem instanceof Error zu machen.

Rckgabewert

Wenn die geworfene Ausnahme von einem try...catch abgefangen wird und der Generator fortfhrt, weitere Werte zu liefern, wird ein Object mit zwei Eigenschaften zurckgegeben:

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 aus dem nchsten yield-Ausdruck gelieferte Wert.

Ausnahmen

TypeError

Wird geworfen, wenn der Generator bereits luft.

Wenn die exception nicht innerhalb der Generatorfunktion von einem try...catch abgefangen wird, wird sie auch an den Aufrufer von throw() geworfen.

Beschreibung

Die throw()-Methode kann, wenn sie aufgerufen wird, als ob eine throw exception;-Anweisung an der aktuellen angehaltenen Position im Krper des Generators eingefgt wird, betrachtet werden, wobei exception die an die throw()-Methode bergebene Ausnahme ist. Daher wird der Generator bei einem typischen Ablauf durch das Aufrufen von throw(exception) werfen. Wenn der yield-Ausdruck jedoch in einem try...catch-Block eingeschlossen ist, kann der Fehler abgefangen und der Kontrollfluss entweder nach der Fehlerbehandlung fortgesetzt oder geordnet beendet werden.

Beispiele

Verwendung von throw()

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

function* gen() {
  while (true) {
    try {
      yield 42;
    } catch (e) {
      console.log("Error caught!");
    }
  }
}

const g = gen();
g.next();
// { value: 42, done: false }
g.throw(new Error("Something went wrong"));
// "Error caught!"
// { value: 42, done: false }

Spezifikationen

Browser-Kompatibilitt

Siehe auch

• function*