Navigator.getUserMedia()

Deprecated
This feature is no longer recommended. Though some browsers might still support it, it may have already been removed from the relevant web standards, may be in the process of being dropped, or may only be kept for compatibility purposes. Avoid using it, and update existing code if possible; see the compatibility table at the bottom of this page to guide your decision. Be aware that this feature may cease to work at any time.

The deprecated Navigator.getUserMedia() method prompts the user for permission to use up to one video input device (such as a camera or shared screen) and up to one audio input device (such as a microphone) as the source for a MediaStream.

If permission is granted, a MediaStream whose video and/or audio tracks come from those devices is delivered to the specified success callback. If permission is denied, no compatible input devices exist, or any other error condition occurs, the error callback is executed with a MediaStreamError object describing what went wrong. If the user instead doesn't make a choice at all, neither callback is executed.

This is a legacy method. Please use the newer navigator.mediaDevices.getUserMedia() instead. While technically not deprecated, this old callback version is marked as such, since the specification strongly encourages using the newer promise returning version.

Syntax

navigator.getUserMedia(constraints, successCallback, errorCallback);

Parameters

constraints
A MediaStreamConstraints object specifying the types of media to request, along with any requirements for each type. For details, see the constraints section under the modern MediaDevices.getUserMedia() method, as well as the article Capabilities, constraints, and settings.
successCallback
A function which is invoked when the request for media access is approved. The function is called with one parameter: the MediaStream object that contains the media stream. Your callback can then assign the stream to the desired object (such as an <audio> or <video> element), as shown in the following example:
function(stream) {
   var video = document.querySelector('video');
   video.srcObject = stream;
   video.onloadedmetadata = function(e) {
      // Do something with the video here.
   };
}
errorCallback
When the call fails, the function specified in the errorCallback is invokedwith a MediaStreamError object as its sole argument; this object is is modeled on DOMException. See {anch("Errors")}} below for a list of the errors which can occur.

Return value

undefined.

Errors

Examples

Width and height

Here's an example of using getUserMedia(), including code to cope with various browsers' prefixes. Note that this is the deprecated way of doing it: See the Examples section under the MediaDevices.getUserMedia() for modern examples.

navigator.getUserMedia = navigator.getUserMedia ||
                         navigator.webkitGetUserMedia ||
                         navigator.mozGetUserMedia;

if (navigator.getUserMedia) {
   navigator.getUserMedia({ audio: true, video: { width: 1280, height: 720 } },
      function(stream) {
         var video = document.querySelector('video');
         video.srcObject = stream;
         video.onloadedmetadata = function(e) {
           video.play();
         };
      },
      function(err) {
         console.log("The following error occurred: " + err.name);
      }
   );
} else {
   console.log("getUserMedia not supported");
}

Browser compatibility

New code should use Navigator.mediaDevices.getUserMedia() instead.

DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidFirefox for AndroidOpera for AndroidSafari on iOSSamsung Internet
getUserMedia
DeprecatedNon-standard
Chrome Full support 53
Full support 53
Full support 21
Prefixed Notes
Prefixed Implemented with the vendor prefix: webkit
Notes An outdated constraint syntax is still in use, but the syntax described here is available through the adapter.js polyfill.
Edge Full support 12Firefox Full support 17
Prefixed Notes
Full support 17
Prefixed Notes
Prefixed Implemented with the vendor prefix: moz
Notes The constraint syntax described here is available as of Firefox 38. Earlier versions (32-37) used an outdated constraint syntax, but the syntax described here is available there through the adapter.js polyfill.
IE No support NoOpera Full support 18
Prefixed
Full support 18
Prefixed
Prefixed Implemented with the vendor prefix: webkit
No support 12 — 15
Notes
Notes An outdated constraint syntax is still in use, but the syntax described here is available through the adapter.js polyfill.
Safari No support NoWebView Android Full support 53
Full support 53
Full support 40
Prefixed Notes
Prefixed Implemented with the vendor prefix: webkit
Notes An outdated constraint syntax is still in use, but the syntax described here is available through the adapter.js polyfill.
Chrome Android Full support 53
Full support 53
Full support 25
Prefixed Notes
Prefixed Implemented with the vendor prefix: webkit
Notes An outdated constraint syntax is still in use, but the syntax described here is available through the adapter.js polyfill.
Firefox Android Full support 24
Prefixed Notes
Full support 24
Prefixed Notes
Prefixed Implemented with the vendor prefix: moz
Notes The constraint syntax described here is available as of Firefox 38. Earlier versions (32-37) used an outdated constraint syntax, but the syntax described here is available there through the adapter.js polyfill.
Opera Android No support 12 — 14
Notes
No support 12 — 14
Notes
Notes An outdated constraint syntax is still in use, but the syntax described here is available through the adapter.js polyfill.
Safari iOS No support NoSamsung Internet Android Full support 6.0
Full support 6.0
Full support 1.5
Prefixed Notes
Prefixed Implemented with the vendor prefix: webkit
Notes An outdated constraint syntax is still in use, but the syntax described here is available through the adapter.js polyfill.

Legend

Full support
Full support
No support
No support
Non-standard. Expect poor cross-browser support.
Non-standard. Expect poor cross-browser support.
Deprecated. Not for use in new websites.
Deprecated. Not for use in new websites.
See implementation notes.
See implementation notes.
Requires a vendor prefix or different name for use.
Requires a vendor prefix or different name for use.

See also