Clarify ReadableStreamBYOBReader.readAtLeast(minBytes, bufferArrayBufferView)

[brettwillis]

Existing documentation URL(s)

https://developers.cloudflare.com/workers/runtime-apis/streams/readablestreambyobreader

What changes are you suggesting?

As per the docs

Returns a promise with the next available chunk of data read into a passed-in buffer. The promise will not resolve until at least minBytes have been read.

What happens if the source stream ends with less than minBytes available? A little bit of sanity would say that it would resolve with the buffer partially filled with the available bytes, rather than rejecting, but that contradicts the absolute statement that "the promise will not resolve until at least minBytes have been read".

Docs should explain what happens in the case of the stream ending with less bytes than requested.

Additional information

No response