MediaStream()

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

newStream = new MediaStream();
newStream = new MediaStream(stream);
newStream = new MediaStream(tracks[]);

Parameters

stream
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
An Array of MediaStreamTrack 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 Status Comment
Media Capture and Streams
The definition of 'MediaStream' in that specification.
Candidate Recommendation

Browser compatibility

BCD tables only load in the browser

See also