TransformStreamDefaultController.desiredSize

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.

Syntax

let desiredSize = TransformStreamDefaultController.desiredSize;

Value

The desired size.

Examples

In the next example the desiredSize is logged to the console.

console.log(controller.desiredSize);

Specifications

Browser compatibility

Desktop Mobile
Chrome Edge Firefox Internet Explorer Opera Safari WebView Android Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet
desiredSize
67
79
No
No
54
14.1
67
67
No
48
14.5
9.0

© 2005–2021 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/TransformStreamDefaultController/desiredSize