ByteLengthQueuingStrategy:ByteLengthQueuingStrategy() 建構函式

Baseline 已廣泛支援

此功能已成熟,並可在多種裝置和瀏覽器版本上使用。自 ⁨2019 年 1 月⁩起,它已在所有瀏覽器中可用。

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

ByteLengthQueuingStrategy() 建構函式用於建立並返回一個 ByteLengthQueuingStrategy 物件例項。

語法

js
new ByteLengthQueuingStrategy(options)

引數

options

一個具有以下屬性的物件

highWaterMark

在應用反壓之前,內部佇列可以包含的總位元組數。

highWaterMark 指定塊計數的 CountQueuingStrategy() 不同,使用 ByteLengthQueuingStrategy() 時,highWaterMark 指定的是位元組數 — 具體來說,給定一個塊流,在應用反壓之前,內部佇列可以包含多少位元組的塊(而不是有多少塊)。

返回值

ByteLengthQueuingStrategy 物件的例項。

異常

無。

示例

js
const queuingStrategy = new ByteLengthQueuingStrategy({
  highWaterMark: 1 * 1024,
});

const readableStream = new ReadableStream(
  {
    start(controller) {
      // …
    },
    pull(controller) {
      // …
    },
    cancel(err) {
      console.log("stream error:", err);
    },
  },
  queuingStrategy,
);

const size = queuingStrategy.size(chunk);

規範

規範
Streams
# blqs-constructor

瀏覽器相容性

另見

  • ByteLengthQueuingStrategy 介面