ReadableByteStreamController: close() Methode

Baseline 2026

Neu verfgbar

Seit Mrz 2026 funktioniert diese Funktion auf aktuellen Gerten und in aktuellen Browserversionen. Auf lteren Gerten oder in lteren Browsern funktioniert sie mglicherweise nicht.

Mehr erfahren
Vollstndige Kompatibilitt anzeigen

Hinweis: Diese Funktion ist in Web Workers verfgbar.

Die close() Methode der ReadableByteStreamController Schnittstelle schliet den zugehrigen Stream.

Dies knnte von der zugrunde liegenden Quelle aufgerufen werden, wenn ihre Datenquelle erschpft/abgeschlossen ist.

Hinweis: Leser knnen weiterhin alle zuvor eingereihten Chunks aus dem Stream lesen, aber sobald diese gelesen sind, wird der Stream geschlossen. Wenn jedoch eine ausstehende und teilweise geschriebene byobRequest besteht, wenn close() aufgerufen wird, wird der Stream fehlerhaft.

Syntax

close()

TypeError: Wird ausgelst, wenn das Quellobjekt kein ReadableByteStreamController ist, es bereits geschlossen ist oder der Stream aus einem anderen Grund nicht lesbar ist.

Beispiele

Das Beispiel in Verwendung von lesbaren Byte-Streams > Erstellen eines lesbaren Socket-Push-Byte-Streams zeigt, wie wir den Stream schlieen knnten, wenn keine Daten mehr vorhanden sind.

Der relevante Code ist unten reproduziert. Dies basiert darauf, dass die hypothetische readInto() Methode nur dann 0 Bytes zurckgibt, wenn keine Daten mehr vorhanden sind.

bytesRead = socket.readInto(v.buffer, v.byteOffset, v.byteLength);
if (bytesRead === 0) {
  controller.close();
}

Nach dem Aufruf von close wird der Stream geschlossen und alle Verbraucher benachrichtigt. Zum Beispiel wrden bei Verwendung eines ReadableStreamBYOBReader alle read() Anfragen mit done: true aufgelst und das Versprechen von ReadableStreamBYOBReader.closed wrde ebenfalls aufgelst.