new ReadableStream([underlyingSource [, strategy]])

新增于: v16.5.0

  • underlyingSource <Object>

    • start <Function> 创建 ReadableStream 时立即调用的用户定义函数。

      ¥start <Function> A user-defined function that is invoked immediately when the ReadableStream is created.

    • pull <Function> 当 ReadableStream 内部队列未满时重复调用的用户定义函数。该操作可以是同步的或异步的。如果是异步的，该函数将不会被再次调用，直到先前返回的 promise 得到满足。

      ¥pull <Function> A user-defined function that is called repeatedly when the ReadableStream internal queue is not full. The operation may be sync or async. If async, the function will not be called again until the previously returned promise is fulfilled.

    • cancel <Function> 取消 ReadableStream 时调用的用户定义函数。

      ¥cancel <Function> A user-defined function that is called when the ReadableStream is canceled.

      • reason <any>

      • 返回：undefined 兑现的 promise。

        ¥Returns: A promise fulfilled with undefined.

    • type <string> 必须是 'bytes' 或 undefined。

      ¥type <string> Must be 'bytes' or undefined.

    • autoAllocateChunkSize <number> 仅在 type 等于 'bytes' 时使用。当设置为非零值时，视图缓冲区会自动分配给 ReadableByteStreamController.byobRequest。如果未设置，则必须使用流的内部队列通过默认读取器 ReadableStreamDefaultReader 传输数据。

      ¥autoAllocateChunkSize <number> Used only when type is equal to 'bytes'. When set to a non-zero value a view buffer is automatically allocated to ReadableByteStreamController.byobRequest. When not set one must use stream's internal queues to transfer data via the default reader ReadableStreamDefaultReader.

  • strategy <Object>

    • highWaterMark <number> 应用背压之前的最大内部队列大小。

      ¥highWaterMark <number> The maximum internal queue size before backpressure is applied.

    • size <Function> 一个用户定义的函数，用于标识每个数据块的大小。

      ¥size <Function> A user-defined function used to identify the size of each chunk of data.