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 January 2020.
Please take two minutes to fill out our short survey.
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 theReadableStreamDefaultReader
interface'sread()
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 newReadableStream
objects, each of which returns the contents of theBlob
. - Call the returned stream's
pipeThrough()
method to pipe the stream through aTransformStream
or any other readable and writable pair.
Specifications
Specification |
---|
File API # dom-blob-stream |