Blob: stream() method
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 |
Browser compatibility
BCD tables only load in the browser