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

js
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 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
Media Capture and Streams
# dom-mediastream-constructor

Browser compatibility

See also