ByteLengthQueuingStrategy: highWaterMark-Eigenschaft

Hinweis: Dieses Feature ist verfügbar in Web Workers.

Die schreibgeschützte ByteLengthQueuingStrategy.highWaterMark-Eigenschaft gibt die Gesamtanzahl von Bytes zurück, die in der internen Warteschlange enthalten sein können, bevor Backpressure angewendet wird.

Hinweis: Anders als bei CountQueuingStrategy(), wo die highWaterMark-Eigenschaft eine einfache Zählung der Anzahl der Blöcke angibt, legt der highWaterMark-Parameter bei ByteLengthQueuingStrategy() eine Anzahl von Bytes fest — insbesondere, wie viele Bytes von diesen Blöcken eines Streams in der internen Warteschlange enthalten sein können (statt der Zählung, wie viele dieser Blöcke), bevor Backpressure angewendet wird.

Werte

Ein ganzzahliger Wert.

Beispiele

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

Spezifikationen

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

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch