ByteLengthQueuingStrategy: highWaterMark-Eigenschaft

Baseline Widely available

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

Hinweis: Diese Funktion ist in Web Workers verfügbar.

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
# ref-for-blqs-high-water-mark①

Browser-Kompatibilität

Siehe auch