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

浏览器兼容性