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 theReadableStreamDefaultReaderinterface'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 newReadableStreamobjects, each of which returns the contents of theBlob. - Call the returned stream's
pipeThrough()method to pipe the stream through aTransformStreamor any other readable and writable pair.
Specifications
| Specification | Status | Comment |
|---|---|---|
| File API The definition of 'Blob.stream()' in that specification. |
Working Draft |
Browser compatibility
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
| Desktop | Mobile | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
stream() | Chrome Full support 76 | Edge Full support 79 | Firefox Full support 69 | IE No support No | Opera No support No | Safari No support No | WebView Android Full support 76 | Chrome Android Full support 76 | Firefox Android No support No | Opera Android Full support 54 | Safari iOS No support No | Samsung Internet Android Full support 12.0 |
Legend
- Full support
- Full support
- No support
- No support
