ReadableStreamDefaultController: desiredSize-Eigenschaft
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Januar 2020 browserübergreifend verfügbar.
Hinweis: Diese Funktion ist in Web Workers verfügbar.
Die schreibgeschützte desiredSize-Eigenschaft der ReadableStreamDefaultController-Schnittstelle gibt die gewünschte Größe zurück, die erforderlich ist, um die interne Warteschlange des Streams zu füllen.
Wert
Eine Zahl oder null.
Die Zahl kann negativ sein, wenn die Warteschlange übervoll ist. Wenn eine benutzerdefinierte Warteschlangenstrategie verwendet wird, können ihre Chunk-Größen dazu führen, dass die Zahl eine gebrochene Komponente hat. Der Wert ist null, wenn der Stream fehlerhaft ist, und 0, wenn er geschlossen ist.
Beispiele
Das Ein lesbarer Stream mit einer zugrunde liegenden Push-Quelle und Unterstützung für Rückstau-Beispiel in der Spezifikation bietet ein gutes Beispiel für die Verwendung von desiredSize, um manuell zu erkennen, wann der Stream voll ist und Rückstau anzuwenden, sowie für die Verwendung von ReadableStreamDefaultController.error(), um manuell einen Stream-Fehler auszulösen, falls ein anderer Teil des Systems, auf den er sich stützt, fehlschlägt.
Spezifikationen
| Spezifikation |
|---|
| Streams # ref-for-rs-default-controller-desired-size② |