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.

See full compatibility

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 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

	desktop					mobile
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox for Android	Opera Android	Safari on iOS	Samsung Internet	WebView Android	WebView on iOS
`MediaStream()` constructor	Chrome – Full support Chrome 21 (Release date: 2012-07-31) prefix prefix Implemented with the vendor prefix: webkit Chrome – Full support Chrome 55 (Release date: 2016-12-01) footnote Full support	Edge – Full support Edge 79 (Release date: 2020-01-15) prefix prefix Implemented with the vendor prefix: webkit Edge – Full support Edge 12 (Release date: 2015-07-29) footnote Full support	Firefox – Full support Firefox 44 (Release date: 2016-01-26) footnote Full support	Opera – Full support Opera 15 (Release date: 2013-07-02) prefix prefix Implemented with the vendor prefix: webkit Opera – Full support Opera 42 (Release date: 2016-12-13) footnote Full support	Safari – Full support Safari 11 (Release date: 2017-09-19) footnote Full support	Chrome Android – Full support Chrome Android 25 (Release date: 2013-02-27) prefix prefix Implemented with the vendor prefix: webkit Chrome Android – Full support Chrome Android 55 (Release date: 2016-12-06) footnote Full support	Firefox for Android – Full support Firefox for Android 42 (Release date: 2015-11-03) footnote Full support	Opera Android – Full support Opera Android 14 (Release date: 2013-05-21) prefix prefix Implemented with the vendor prefix: webkit Opera Android – Full support Opera Android 42 (Release date: 2017-01-21) footnote Full support	Safari on iOS – Full support Safari on iOS 11 (Release date: 2017-09-19) footnote Full support	Samsung Internet – Full support Samsung Internet 1.5 (Release date: 2013-09-25) prefix prefix Implemented with the vendor prefix: webkit Samsung Internet – Full support Samsung Internet 6 (Release date: 2017-08-23) footnote Full support	WebView Android – Full support WebView Android 4.4 (Release date: 2013-12-09) prefix prefix Implemented with the vendor prefix: webkit WebView Android – Full support WebView Android 55 (Release date: 2016-12-06) footnote Full support	WebView on iOS – Full support WebView on iOS 11 (Release date: 2017-09-19) footnote Full support

Tip: you can click/tap on a cell for more information.

Full support: Full support
: Requires a vendor prefix or different name for use.
: Has more compatibility info.