TransformStreamDefaultController: error() 方法

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

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

规范

规范
流标准
# ts-default-controller-error

浏览器兼容性

BCD 表格仅在浏览器中加载