ReadableByteStreamController: byobRequest-Eigenschaft

Baseline 2026

Neu verfügbar

Seit March 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 Eigenschaft byobRequest der Schnittstelle ReadableByteStreamController gibt die aktuelle BYOB-Anfrage zurück oder null, wenn es keine ausstehenden Anfragen gibt.

Eine zugrunde liegende Byte-Quelle sollte diese Eigenschaft überprüfen und verwenden, um Daten in den Stream zu schreiben, falls sie existiert (anstatt ReadableByteStreamController.enqueue() zu nutzen). Dies führt zu einem effizienten Null-Byte-Transfer der Daten zum Verbraucher.

In diesem Artikel

Wert

Ein ReadableStreamBYOBRequest-Objektinstanz oder null.

Beispiele

Das Beispiel in Verwendung von lesbaren Bytestreams > Erstellen eines lesbaren Socket-Push-Bytestreams zeigt, wie Sie eine byobRequest verwenden, um Daten zu übertragen (falls sie existiert), oder anderweitig die Daten in die internen Warteschlangen des Streams mithilfe von ReadableByteStreamController.enqueue() zu kopieren.

Der relevante Code wird unten wiedergegeben. Falls eine byobRequest existiert, werden die Daten in controller.byobRequest.view gelesen und dann wird ReadableStreamBYOBRequest.respond() aufgerufen, um die Menge der Daten zu signalisieren, die für den Transfer bereit sind.

js
if (controller.byobRequest) {
  const v = controller.byobRequest.view;
  bytesRead = socket.readInto(v.buffer, v.byteOffset, v.byteLength);
  if (bytesRead === 0) {
    controller.close();
  }
  controller.byobRequest.respond(bytesRead);
} else {
  // Write to data using enqueue().
}

Help improve MDN

War diese Übersetzung hilfreich?

Ja Nein

Erfahren Sie, wie Sie beitragen können Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden

Streams API
ReadableByteStreamController
Instanzeigenschaften
1. byobRequest
2. desiredSize
Instanzmethoden
Verwandte Seiten für Streams
Anleitungen
1. Streams API Konzepte
2. Verwendung von lesbaren Streams
3. Verwendung von lesbaren Bytestreams
4. Verwenden von beschreibbaren Streams

ReadableByteStreamController: byobRequest-Eigenschaft

In diesem Artikel

Wert

Beispiele

Spezifikationen

Browser-Kompatibilität

Siehe auch

Help improve MDN