ImageCapture.ImageCapture()

Non-standard
This feature is non-standard and is not on a standards track. Do not use it on production sites facing the Web: it will not work for every user. There may also be large incompatibilities between implementations and the behavior may change in the future.

The ImageCapture constructor creates a new ImageCapture object which creates a new ImageCapture object.

Syntax

var 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 Capture
The definition of 'ImageCapture' in that specification.
Working Draft Initial definition.

Browser compatibility

Update compatibility data on GitHub
DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidEdge MobileFirefox for AndroidOpera for AndroidiOS SafariSamsung Internet
Basic support
Experimental
Chrome Full support 59Edge ? Firefox ? IE ? Opera Full support 46Safari ? WebView Android Full support 59Chrome Android Full support 59Edge Mobile ? Firefox Android ? Opera Android Full support 46Safari iOS ? Samsung Internet Android Full support 7.0

Legend

Full support  
Full support
Compatibility unknown  
Compatibility unknown
Experimental. Expect behavior to change in the future.
Experimental. Expect behavior to change in the future.

Document Tags and Contributors

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