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 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 | Status | Comment |
File APIThe 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.
Update compatibility data on GitHub
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
See also
Blob.stream() by Mozilla Contributors is licensed under CC-BY-SA 2.5.