Blob.stream()

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

Syntax

var stream = blob.stream();

Parameters

None.

Returns

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

BCD tables only load in the browser

See also