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 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 |
Browser compatibility
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | |
stream |
76 |
79 |
69 |
No |
No |
14.1 |
76 |
76 |
No |
54 |
14.5 |
12.0 |
See also
© 2005–2021 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/Blob/stream