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 CanvasCaptureMediaStream interface represents a MediaStream capturing in real-time the surface of an HTMLCanvasElement.
Properties
This interface inherits the properties of its parents, MediaStream and EventTarget.
CanvasCaptureMediaStream.canvasRead only- Returns the
HTMLCanvasElementobject whose surface is captured in real-time.
Methods
This interface inherits the methods of its parent, MediaStream and EventTarget.
CanvasCaptureMediaStream.requestFrame()- Manually forces a frame to be captured and sent to the stream. This allows to capture partially rendered frames.
Specifications
| Specification | Status | Comment |
|---|---|---|
| Media Capture from DOM Elements The definition of 'CanvasCaptureMediaStream' in that specification. |
Editor's Draft | Initial definition |
Browser compatibility
| Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari (WebKit) |
|---|---|---|---|---|---|
| Basic support | 51.0 | 41 (41)[1] | No support | No support | No support |
| Feature | Android | Firefox Mobile (Gecko) | IE Phone | Opera Mobile | Safari Mobile |
|---|---|---|---|---|---|
| Basic support | No support | 41.0 (41)[1] | No support | No support | No support |
[1] Disabled by default; set the preference canvas.capturestream.enabled to true to activate.