TransformStreamDefaultController: error()-Methode

Hinweis: Diese Funktion ist in Web Workers verfügbar.

Die error()-Methode der TransformStreamDefaultController-Schnittstelle bewirkt, dass beide Seiten des Streams auf Fehler gesetzt werden. Jegliche weitere Interaktionen damit werden mit der angegebenen Fehlermeldung fehlschlagen, und alle Chunks in der Warteschlange werden verworfen.

Syntax

error(reason)

Parameter

reason: Ein String, der die Fehlermeldung enthält, die bei jeder weiteren Interaktion mit dem Stream zurückgegeben wird.

Rückgabewert

Keiner (undefined).

Beispiele

In diesem Beispiel wird die error()-Methode verwendet, wenn ein Chunk nicht transformiert werden konnte.

const transformContent = {
  start() {
    /* … */
  },
  async transform(chunk, controller) {
    try {
      chunk = await applyMyTransformation(chunk);
    } catch (err) {
      controller.error(`Unable to transform chunk: ${err}`);
    }
    // …
  },
  // …
};

Spezifikationen

Specification
Streams Standard # ts-default-controller-error

Browser-Kompatibilität

BCD tables only load in the browser