ReadableByteStreamController: desiredSize-Eigenschaft
Baseline 2026
Neu verfügbar
Seit März 2026 funktioniert diese Funktion auf aktuellen Geräten und in aktuellen Browserversionen. Auf älteren Geräten oder in älteren Browsern funktioniert sie möglicherweise nicht.
Hinweis: Diese Funktion ist in Web Workers verfügbar.
Die schreibgeschützte desiredSize-Eigenschaft der ReadableByteStreamController-Schnittstelle gibt die Anzahl von Bytes zurück, die erforderlich sind, um die interne Warteschlange des Streams auf ihre "gewünschte Größe" zu füllen.
Der Wert wird vom Stream verwendet, um eine bevorzugte Flussrate für die zugrunde liegende Quelle anzugeben. Quellen, die eine Drosselung oder ein Pausieren ihres Datenzuflusses unterstützen (das tun nicht alle!), sollten den Zufluss so steuern, dass desiredSize des Stream-Puffers positiv und so nahe wie möglich bei null gehalten wird.
Das desiredSize wird verwendet, um Gegendruck (backpressure) von nachgelagerten Verbrauchern anzuwenden.
Wert
Eine Zahl oder null.
Die Zahl kann negativ sein, wenn die Warteschlange überfüllt ist. Obwohl die Warteschlangengröße in Bytes gemessen wird, kann eine gebrochene Hohe Wasserstandsmarke (high water mark) dazu führen, dass die Zahl eine gebrochene Komponente hat. Der Wert ist null, wenn der Stream einen Fehler hat und 0, wenn er geschlossen ist.
Beispiele
Das Ein leserlicher Stream mit einer zugrunde liegenden Push-Quelle und Unterstützung für Gegendruck-Beispiel in der Spezifikation bietet ein gutes Beispiel dafür, wie desiredSize verwendet wird, um manuell festzustellen, wann der Stream voll ist und Gegendruck anzuwenden.
Während das Beispiel eine Standardquelle verwendet, sind die Konzepte genau die gleichen wie bei lesbaren Bytequellen.
Spezifikationen
| Spezifikation |
|---|
| Streams # ref-for-rbs-controller-desired-size② |