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

View in English Always switch to English

ReadableStreamDefaultController.error()

基线 广泛可用

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

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

备注:error() 方法可以被多次调用,并且可以在流不可读时被调用。

语法

js
error(e)

参数

e

你需要在后面使用的错误信息。

返回值

无 (undefined)。

异常

TypeError

如果源对象不是 ReadableStreamDefaultController 则抛出异常。

示例

规范中具有底层推送源和背压支持的流提供了一个很好的例子,说明如何使用 ReadablestreamDefaultController.desiredSize 去手动检测流何时已满并使用背压,以及流所依赖的系统在部分失效的情况下如何使用 error() 去手动触发一个流错误。

规范

规范
Streams
# rs-default-controller-error

浏览器兼容性

参见