ByteLengthQueuingStrategy：highWaterMark 属性

注意：此功能在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①

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。

另请参阅