ReadableByteStreamController: desiredSize 屬性

可用性有限

此特性不是基線特性,因為它在一些最廣泛使用的瀏覽器中不起作用。

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

ReadableByteStreamController 介面的只讀屬性 desiredSize 返回用於將流的內部佇列填充到其“期望大小”所需的位元組數。

該值由流用於向底層源指示首選的流速。支援限制或暫停資料流入的源(並非所有源都支援!)應控制流入,以使流緩衝區的 desiredSize 保持為正數且儘可能接近零。

desiredSize 用於從下游消費者應用背壓

一個整數。請注意,如果佇列已滿,該值可以為負數。

如果流出錯,該值將為 null;如果流已關閉,則為 0

示例

規範中的具有底層推送源和背壓支援的可讀流示例很好地說明了如何使用 desiredSize 手動檢測流何時已滿並應用背壓。

雖然示例使用的是預設源,但其概念與可讀位元組源完全相同。

規範

規範
Streams
# ref-for-rbs-controller-desired-size②

瀏覽器相容性

另見