ImageCapture: ImageCapture() constructor
The ImageCapture() constructor
creates a new ImageCapture object.
Syntax
js
new ImageCapture(videoTrack)
Parameters
videoTrack-
A
MediaStreamTrackfrom 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.
Exceptions
NotSupportedErrorDOMException-
Thrown if the
videoTrackparameter'skindproperty is notvideo.
Examples
The following example shows how to use a call to
MediaDevices.getUserMedia() to retrieve the
MediaStreamTrack needed by the ImageCapture() constructor.
js
navigator.mediaDevices
.getUserMedia({ video: true })
.then((mediaStream) => {
document.querySelector("video").srcObject = mediaStream;
const track = mediaStream.getVideoTracks()[0];
imageCapture = new ImageCapture(track);
})
.catch((error) => console.error(error));
Specifications
| Specification |
|---|
| MediaStream Image Capture # dom-imagecapture-imagecapture |
Browser compatibility
| desktop | mobile | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
ImageCapture() constructor
|
|
|
|
|
|
|
|
|
|
|
|
|
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support
- No support
- No support
- User must explicitly enable this feature.