此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。

View in English Always switch to English

ByteLengthQueuingStrategy:highWaterMark 属性

基线 广泛可用

自 2019年1月 起,此特性已在主流浏览器中得到支持,可在大多数设备和浏览器版本中正常使用。

只读属性 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①

浏览器兼容性

参见