WritableStreamDefaultWriter: desiredSize Eigenschaft
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Mai 2022 browserübergreifend verfügbar.
Hinweis: Diese Funktion ist in Web Workers verfügbar.
Die schreibgeschützte Eigenschaft desiredSize des WritableStreamDefaultWriter-Interfaces gibt die gewünschte Größe an, die benötigt wird, um die interne Warteschlange des Streams zu füllen.
Wert
Ein Integer. Beachten Sie, dass dieser negativ sein kann, wenn die Warteschlange überfüllt ist.
Der Wert ist null, wenn der Stream nicht erfolgreich beschrieben werden kann (entweder aufgrund eines Fehlers oder weil ein Abbruch ansteht), und null wenn der Stream geschlossen ist.
Ausnahmen
TypeError-
Die Sperre des Schreibers wurde freigegeben.
Beispiele
js
const writableStream = new WritableStream(
{
write(chunk) {
// …
},
close() {
// …
},
abort(err) {
// …
},
},
queuingStrategy,
);
// …
const writer = writableStream.getWriter();
// …
// return stream's desired size
const size = writer.desiredSize;
Spezifikationen
| Spezifikation |
|---|
| Streams # ref-for-default-writer-desired-size⑥ |