ByteLengthQueuingStrategy: highWaterMark 屬性

Baseline 已廣泛支援

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

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

只讀的 ByteLengthQueuingStrategy.highWaterMark 屬性返回內部佇列在應用背壓之前可以包含的總位元組數。

注意:CountQueuingStrategy() 不同(後者中的 highWaterMark 屬性指定了塊的簡單計數),對於 ByteLengthQueuingStrategy()highWaterMark 引數指定了位元組數——具體來說,給定一個塊流,在應用背壓之前,內部佇列可以包含多少位元組的那些塊(而不是那些塊的計數)。

一個整數。

示例

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);
console.log(`highWaterMark value: ${queuingStrategy.highWaterMark}$`);

規範

規範
Streams
# ref-for-blqs-high-water-mark①

瀏覽器相容性

另見