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

View in English Always switch to English

WritableStreamDefaultController.error()

基线 广泛可用

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

WritableStreamDefaultController 接口的 error() 方法会导致未来任何与关联的流的交互出错。

这个方法很少被使用,因为通常从底层接收器的一个方法返回一个拒绝的 promise 足矣。但是,在响应与底层接收器交互的正常生命周期之外的事件中,使用 error() 来立即关闭一个流则会很有用。

语法

js
error(message)

参数

message

一个字符串,表示你希望在调用该方法以后的交互所应该抛出的错误。

返回值

无(undefined)。

异常

TypeError

你尝试调用 error 方法的流不是一个 WritableStream

示例

js
const writableStream = new WritableStream({
  start(controller) {
    // do stuff with controller
    // error stream if necessary
    controller.error('My error is broken');
  },
  write(chunk, controller) {
    ...
  },
  close(controller) {
    ...
  },
  abort(err) {
    ...
  }
});

规范

规范
Streams
# ref-for-ws-default-controller-error①

浏览器兼容性