ReadableByteStreamController: desiredSize 属性

可用性有限

此特性不是基线特性,因为它在一些最广泛使用的浏览器中不起作用。

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

ReadableByteStreamController 接口的只读属性 desiredSize 返回用于将流的内部队列填充到其“期望大小”所需的字节数。

该值由流用于向底层源指示首选的流速。支持限制或暂停数据流入的源(并非所有源都支持!)应控制流入,以使流缓冲区的 desiredSize 保持为正数且尽可能接近零。

desiredSize 用于从下游消费者应用背压

一个整数。请注意,如果队列已满,该值可以为负数。

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

示例

规范中的具有底层推送源和背压支持的可读流示例很好地说明了如何使用 desiredSize 手动检测流何时已满并应用背压。

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

规范

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

浏览器兼容性

另见