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

js
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.

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

Spezifikationen

Specification
Streams
# ts-default-controller-error

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
error

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support