TransformStreamDefaultController: error()-Methode

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since June 2022.

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