此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。

View in English Always switch to English

TransformStreamDefaultController:error() 方法

基线 广泛可用

自 2022年6月 起,此特性已在主流浏览器中得到支持,可在大多数设备和浏览器版本中正常使用。

备注: 此特性在 Web Worker 中可用。

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(`无法转换分块:${err}`);
    }
    // …
  },
  // …
};

规范

规范
Streams
# ts-default-controller-error

浏览器兼容性