ByteLengthQueuingStrategy: ByteLengthQueuingStrategy() Konstruktor

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

Der ByteLengthQueuingStrategy() Konstruktor erstellt und gibt eine Instanz eines ByteLengthQueuingStrategy-Objekts zurück.

Syntax

js
new ByteLengthQueuingStrategy(options)

Parameter

options

Ein Objekt mit der folgenden Eigenschaft:

highWaterMark

Die Gesamtanzahl von Bytes, die in der internen Warteschlange enthalten sein können, bevor Druck auf die Datenquelle ausgeübt wird.

Im Gegensatz zur CountQueuingStrategy(), bei der highWaterMark eine einfache Zählung der Anzahl der Datenblöcke angibt, spezifiziert highWaterMark bei ByteLengthQueuingStrategy() eine Anzahl von Bytes — insbesondere, bei einem Datenstrom von Blöcken, wie viele Bytes dieser Blöcke (anstatt der Zählung der Blöcke) in der internen Warteschlange enthalten sein können, bevor Druck auf die Datenquelle ausgeübt wird.

Rückgabewert

Eine Instanz des ByteLengthQueuingStrategy-Objekts.

Ausnahmen

Keine.

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

Spezifikationen

Specification
Streams Standard
# blqs-constructor

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch