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 January 2019.

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 an Bytes, die in der internen Warteschlange enthalten sein können, bevor Rückdruck angewendet wird.

Im Gegensatz zu CountQueuingStrategy(), bei der highWaterMark eine einfache Anzahl von Fragmenten angibt, gibt highWaterMark bei ByteLengthQueuingStrategy() eine Anzahl von Bytes an — speziell, wie viele Bytes dieser Fragmente in der internen Warteschlange enthalten sein können, bevor Rückdruck angewendet wird, anstelle einer Zählung, wie viele dieser Fragmente enthalten sein können.

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