TransformStreamDefaultController: error() メソッド

error() は TransformStreamDefaultController インターフェイスのメソッドで、両側のストリームをエラーにします。これ以上何か操作をすると、指定されたエラーメッセージとともに失敗するようになり、キュー内のチャンクは破棄されます。

構文

js
error(reason)

引数

reason

それ以降のストリームの操作において返されるエラーメッセージを格納した文字列。

返値

なし (undefined)。

例

この例では、チャンクが変換できなかったときに error() メソッドを使用しています。

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

仕様書

Specification
Streams Standard
# ts-default-controller-error

ブラウザーの互換性

BCD tables only load in the browser