The ImageCapture()
constructor creates a new ImageCapture
object.
Syntax
const imageCapture = new ImageCapture(videoTrack)
Parameters
videoTrack
- A
MediaStreamTrack
from which the still images will be taken. This can be any source, such as an incoming stream of a video conference, a playing movie, or the stream from a webcam.
Return value
A new ImageCapture
object which can be used to capture still frames from the specified video track.
Example
The following example shows how to use a call to MediaDevices.getUserMedia()
to retrieve the MediaStreamTrack
needed by the ImageCapture()
constructor.
navigator.mediaDevices.getUserMedia({video: true})
.then(mediaStream => {
document.querySelector('video').srcObject = mediaStream
const track = mediaStream.getVideoTracks()[0];
imageCapture = new ImageCapture(track);
})
.catch(error => console.log(error));
Specifications
Specification | Status | Comment |
MediaStream Image CaptureThe definition of 'ImageCapture' in that specification. | Working Draft | Initial definition. |
Browser compatibility
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Update compatibility data on GitHub
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Chrome
Full support 59 |
Edge
Full support ≤79 |
Firefox
? |
IE
No support No |
Opera
Full support 46 |
Safari
? |
WebView Android
Full support 59 |
Chrome Android
Full support 59 |
Firefox Android
? |
Opera Android
Full support 43 |
Safari iOS
? |
Samsung Internet Android
Full support 7.0 |
Legend
- Full support
- Full support
- No support
- No support
- Compatibility unknown
- Compatibility unknown
- Experimental. Expect behavior to change in the future.'
- Experimental. Expect behavior to change in the future.
ImageCapture() constructor by Mozilla Contributors is licensed under CC-BY-SA 2.5.