ByteLengthQueuingStrategy: ByteLengthQueuingStrategy() Konstruktor

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.

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
# blqs-constructor

Browser-Kompatibilität

Siehe auch