ByteLengthQueuingStrategy: thuộc tính highWaterMark

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since January 2019.

Note: This feature is available in Web Workers.

Thuộc tính chỉ đọc ByteLengthQueuingStrategy.highWaterMark trả về tổng số byte có thể được chứa trong hàng đợi nội bộ trước khi backpressure được áp dụng.

Note: Không giống CountQueuingStrategy(), nơi thuộc tính highWaterMark chỉ định số lượng chunk một cách đơn giản, với ByteLengthQueuingStrategy(), tham số highWaterMark chỉ định số byte, cụ thể là với một stream gồm các chunk, tổng số byte của các chunk đó (thay vì số lượng chunk) có thể được chứa trong hàng đợi nội bộ trước khi backpressure được áp dụng.

Giá trị

Một số nguyên.

Ví dụ

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}$`);

Thông số kỹ thuật

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

Khả năng tương thích với trình duyệt

Xem thêm