ReadableByteStreamController

Das ReadableByteStreamController-Interface der Streams-API repräsentiert einen Controller für einen lesbaren Bytestream. Es ermöglicht die Steuerung des Zustands und der internen Warteschlange eines ReadableStream mit einer zugrunde liegenden Bytequelle und erlaubt effiziente Zero-Copy-Übertragungen von Daten von der zugrunde liegenden Quelle zu einem Verbraucher, wenn die interne Warteschlange des Streams leer ist.

Eine Instanz dieses Controller-Typs wird erstellt, wenn ein underlyingSource-Objekt mit der Eigenschaft type="bytes" als Argument an den ReadableStream() Konstruktor übergeben wird. Das underlyingSource-Objekt kann auch start()- und pull()-Callback-Funktionen definieren. Diese werden mit dem Controller als Parameter aufgerufen, um die zugrunde liegende Quelle einzurichten und bei Bedarf Daten anzufordern.

Die zugrunde liegende Quelle verwendet den Controller, um über seine byobRequest-Eigenschaft oder die enqueue()-Methode Daten an den Stream zu liefern. byobRequest ist ein ReadableStreamBYOBRequest-Objekt, das eine ausstehende Anfrage von einem Verbraucher darstellt, eine Zero-Copy-Übertragung der Daten direkt an einen Verbraucher vorzunehmen. byobRequest muss verwendet werden, um Daten zu kopieren, wenn es existiert (verwenden Sie in diesem Fall nicht enqueue())! Wenn die zugrunde liegende Quelle Daten an den Stream übergeben muss und byobRequest null ist, kann die Quelle enqueue() aufrufen, um die Daten der internen Warteschlange des Streams hinzuzufügen.

Beachten Sie, dass byobRequest nur im "BYOB-Modus" erstellt wird, wenn eine Anfrage von einem Leser vorliegt und die interne Warteschlange des Streams leer ist. Der "BYOB-Modus" wird aktiviert, wenn ein ReadableStreamBYOBReader verwendet wird (typischerweise konstruiert durch Aufruf von ReadableStream.getReader() mit dem Argument { mode: 'byob' }). Er wird auch aktiviert, wenn ein Standardleser verwendet wird und autoAllocateChunkSize im ReadableStream() Konstruktor angegeben ist.

Eine zugrunde liegende Bytequelle kann auch den Controller verwenden, um den Stream mit close() zu schließen, wenn alle Daten gesendet wurden, und Fehler aus der zugrunde liegenden Quelle mit error() zu melden. Die desiredSize-Eigenschaft des Controllers wird verwendet, um "Backpressure" anzuwenden, indem sie der zugrunde liegenden Quelle die Größe der internen Warteschlange mitteilt (kleine Werte weisen darauf hin, dass sich die Warteschlange füllt und es für die zugrunde liegende Quelle wünschenswert ist, den Zustrom zu pausieren oder zu drosseln).

Beachten Sie, dass auch wenn der Controller hauptsächlich von der zugrunde liegenden Bytequelle verwendet wird, es keinen Grund gibt, warum er nicht von anderen Teilen des Systems gespeichert und verwendet werden kann, um dem Stream Signale zu geben.