TransformStreamDefaultController: desiredSize-Eigenschaft
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juni 2022 browserübergreifend verfügbar.
Hinweis: Diese Funktion ist in Web Workers verfügbar.
Die desiredSize-Schreibgeschützte Eigenschaft des TransformStreamDefaultController-Interfaces gibt die gewünschte Größe zurück, um die Warteschlange des zugehörigen ReadableStream zu füllen.
Die interne Warteschlange eines ReadableStream enthält Chunks, die eingereiht, aber noch nicht gelesen wurden. Der Browser bestimmt die gewünschte Größe, um den Stream zu füllen, und dieser Wert wird von der desiredSize-Eigenschaft zurückgegeben.
Wenn die desiredSize 0 ist, dann ist die Warteschlange voll. Daher können Sie diese Information verwenden, um manuell Gegendruck anzuwenden, um die Warteschlange zu verwalten.
Wert
Eine Zahl oder null.
Die Zahl kann negativ sein, wenn die Warteschlange überfüllt ist. Wenn eine benutzerdefinierte Lesewarteschlangenstrategie verwendet wird, können ihre Chunk-Größen dazu führen, dass die Zahl eine gebrochene Komponente hat. Der Wert ist null, wenn die lesbare Seite fehlerhaft ist, und 0, wenn sie geschlossen ist.
Beispiele
Im nächsten Beispiel wird die desiredSize in die Konsole geloggt.
console.log(controller.desiredSize);
Spezifikationen
| Spezifikation |
|---|
| Streams # ts-default-controller-desired-size |