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

Browser compatibility

See also

• MediaStream