ReadableByteStreamController:desiredSize 属性

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

desiredSizeReadableByteStreamController 接口的只读属性,它返回填充流的内部队列到其“所需大小”所需的字节数。

该值用于指示流向基础源的首选流速。支持对其数据流入进行节流或暂停的源(并非所有源都支持!)应控制流入,以便流缓冲区的 desiredSize 保持为正数,并尽可能接近于零。

desiredSize 用于从下游使用者应用背压

一个整数。请注意,如果队列已满,则此值可能为负数。

如果流已出错,则该值为 null;如果流已关闭,则该值为 0

示例

规范中的具有基础推送源和背压支持的可读流示例提供了一个使用 desiredSize 手动检测流何时已满并应用背压的良好示例。

虽然该示例使用了默认源,但其概念与可读字节源完全相同。

规范

规范
Streams 标准
# ref-for-rbs-controller-desired-size②

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。

另请参阅