Blob: stream() method

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since April 2021.

Note: This feature is available in Web Workers.

The stream() method of the Blob interface returns a ReadableStream which upon reading returns the data contained within the Blob.

Syntax

js
stream()

Parameters

None.

Return value

A ReadableStream which, upon reading, returns the contents of the Blob.

Usage notes

With stream() and the returned ReadableStream, you gain several interesting capabilities:

  • Call getReader() on the returned stream to get an object to use to read the data from the blob using methods such as the ReadableStreamDefaultReader interface's read() method.
  • Call the returned stream's pipeTo() method to pipe the blob's data to a writable stream.
  • Call the returned stream's tee() method to tee the readable stream. This returns an array containing two new ReadableStream objects, each of which returns the contents of the Blob.
  • Call the returned stream's pipeThrough() method to pipe the stream through a TransformStream or any other readable and writable pair.

Specifications

Specification
File API
# dom-blob-stream

Browser compatibility

See also