ReadableStreamDefaultController: error() 方法

Baseline 已广泛支持

此特性已相当成熟,可在许多设备和浏览器版本上使用。自 ⁨2020 年 1 月⁩ 起,所有主流浏览器均已支持。

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

ReadableStreamDefaultController 接口的 error() 方法会使与该流相关的任何未来交互都发生错误。

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

语法

js
error(e)

参数

e

你希望未来交互失败的错误。

返回值

无(undefined)。

异常

TypeError

如果源对象不是 ReadableStreamDefaultController,则抛出此错误。

示例

规范中的 具有底层推送源和反压支持的可读流 示例很好地展示了如何使用 ReadableStreamDefaultController.desiredSize 手动检测流何时已满并应用反压,以及如何使用 error() 手动触发流错误(如果其依赖的其他系统部分失败)。

规范

规范
Streams
# rs-default-controller-error

浏览器兼容性

另见