ByteLengthQueuingStrategy：highWaterMark 属性

只读属性 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}$`);

规范

Specification
Streams Standard
# ref-for-blqs-high-water-mark①

浏览器兼容性

BCD tables only load in the browser

参见