[whatwg/streams] explain better what the pull method should do in the underlying source API (Issue #1228)

The specification of the pull method in [4.2.3](https://streams.spec.whatwg.org/#underlying-source-api) doesn't actually say how it's supposed to return new chunks. From [example 10.4](https://streams.spec.whatwg.org/#example-rs-pull) it seems that the way to return new chunks is to call controller.enqueue(), which is the same as a push source. But it should probably say so explicitly?

Or, possibly this could be explained in the [mdn documentation](https://developer.mozilla.org/en-US/docs/Web/API/ReadableStream/ReadableStream) if it doesn't belong in the spec. As it is, how to implement a push method is somewhat mysterious.

-- 
Reply to this email directly or view it on GitHub:
https://github.com/whatwg/streams/issues/1228
You are receiving this because you are subscribed to this thread.

Message ID: <whatwg/streams/issues/1228@github.com>

Received on Tuesday, 26 April 2022 03:57:04 UTC