TransformStreamDefaultController: desiredSize property

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨June 2022⁩.

Note: This feature is available in Web Workers.

The desiredSize read-only property of the TransformStreamDefaultController interface returns the desired size to fill the queue of the associated ReadableStream.

The internal queue of a ReadableStream contains chunks that have been enqueued, but not yet read. The browser determines the desired size to fill the stream, and it is this value returned by the desiredSize property.

If the desiredSize is 0 then the queue is full. Therefore you can use this information to manually apply backpressure to manage the queue.