HTMLMediaElement.captureStream()

This article needs a technical review. How you can help.

This article needs an editorial review. How you can help.

This is an experimental technology
Because this technology's specification has not stabilized, check the compatibility table for usage in various browsers. Also note that the syntax and behavior of an experimental technology is subject to change in future versions of browsers as the specification changes.

The captureStream() property of the HTMLMediaElement interface returns in a MediaStream object a real-time capture of the media that is rendered to the media element.

Syntax

var mediaStream = mediaElement.captureStream()

Parameters

None.

Returns

MediaStream object.

Example

document.querySelector('.playAndRecord').addEventListener('click', function() {
  var paybackElement = document.getElementById("playback");
  var captureStream = playbackElement.captureStream();
  playbackElement.play();
});

Specifications

Specification Status Comment
HTML Media Capture
The definition of 'captureStream()' in that specification.
Candidate Recommendation Initial definition.

Browser Compatibility

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
Basic support 53.0 ? ? ? ?
Feature Android Android Webview Firefox Mobile (Gecko) Firefox OS IE Mobile Opera Mobile Safari Mobile Chrome for Android
Basic support No support 53.0 ? ? ? ? ? 53.0

Document Tags and Contributors

 Contributors to this page: jpmedley
 Last updated by: jpmedley,