Cloudflare Docs
Workers
Edit this page on GitHub
Set theme to dark (⇧+D)

ReadableStream

​​ Background

A ReadableStream is returned by the readable property inside TransformStream. On the Workers ecosystem, ReadableStream cannot be created directly using the ReadableStream constructor.

​​ Properties

  • locked boolean
    • A Boolean value that indicates if the readable stream is locked to a reader.

​​ Methods

  • pipeTo(destinationWritableStream, optionsPipeToOptions) : Promise<void>

    • Pipes the readable stream to a given writable stream destination and returns a promise that is fulfilled when the write operation succeeds or rejects it if the operation fails.
  • getReader(optionsObject) : ReadableStreamDefaultReader

    • Gets an instance of ReadableStreamDefaultReader and locks the ReadableStream to that reader instance. This method accepts an object argument indicating options. The only supported option is mode, which can be set to byob to create a ReadableStreamBYOBReader, as shown here:
let reader = readable.getReader({ mode: 'byob' });

​​ PipeToOptions

  • preventClose bool

    • When true, closure of the source ReadableStream will not cause the destination WritableStream to be closed.
  • preventAbort bool

    • When true, errors in the source ReadableStream will no longer abort the destination WritableStream. pipeTo will return a rejected promise with the error from the source or any error that occurred while aborting the destination.