ByteLengthQueuingStrategy: highWaterMark-Eigenschaft
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Januar 2019 browserübergreifend verfügbar.
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
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
| Spezifikation |
|---|
| Streams # ref-for-blqs-high-water-mark① |
Browser-Kompatibilität
Siehe auch
ByteLengthQueuingStrategy()Konstruktor