ByteLengthQueuingStrategy: ByteLengthQueuingStrategy() 构造函数

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

ByteLengthQueuingStrategy() 构造函数创建并返回一个 ByteLengthQueuingStrategy 对象实例。

语法

new ByteLengthQueuingStrategy(options)

参数

options

具有以下属性的对象

highWaterMark

在应用背压之前，内部队列中可以包含的字节总数。

与 CountQueuingStrategy() 不同，其中 highWaterMark 指定的是 chunk 数量的简单计数，对于 ByteLengthQueuingStrategy()，highWaterMark 指定的是字节数量 - 特别地，对于一组 chunk，指定的是在应用背压之前，内部队列中可以包含的这些 chunk 中的多少字节（而不是这些 chunk 的数量）。

返回值

ByteLengthQueuingStrategy 对象的实例。

异常

无。

示例

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);

规范

规范
流标准 # blqs-constructor

浏览器兼容性

BCD 表格仅在浏览器中加载

另请参阅

ByteLengthQueuingStrategy 接口