MediaStream: MediaStream() constructor
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2017.
The MediaStream()
constructor returns a newly-created MediaStream
, which serves as a collection of media tracks, each represented by a MediaStreamTrack
object.
If any parameters are given, the specified tracks are added to the new stream. Otherwise, the stream has no tracks.
Syntax
new MediaStream()
new MediaStream(stream)
new MediaStream(tracks)
Parameters
stream
Optional-
A different
MediaStream
object whose tracks are added to the newly-created stream automatically. The tracks are not removed from the original stream, so they're shared by the two streams. tracks
Optional-
An
Array
ofMediaStreamTrack
objects, one for each track to add to the stream.
Return value
A newly-created MediaStream
object, either empty, or containing the
tracks provided, if any.
Specifications
Specification |
---|
Media Capture and Streams # dom-mediastream-constructor |