TransformStreamDefaultController: error() 方法

Baseline 已廣泛支援

此特性已得到充分確立,可在多種裝置和瀏覽器版本上執行。自 ⁨2022 年 6 月⁩起,所有瀏覽器均支援此特性。

注意:此功能在 Web Workers 中可用。

TransformStreamDefaultController 介面的 error() 方法會使流的兩端都出錯。任何進一步與之的互動都將因給定的錯誤訊息而失敗,並且佇列中的任何資料塊都將被丟棄。

語法

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}`);
    }
    // …
  },
  // …
};

規範

規範
Streams
# ts-default-controller-error

瀏覽器相容性