MediaDevices.getSupportedConstraints()

The getSupportedConstraints() method of the MediaDevices interface returns an object based on the MediaTrackSupportedConstraints dictionary, whose member fields each specify one of the constrainable properties the user agent understands.

Syntax

var supportedConstraints = navigator.mediaDevices.getSupportedConstraints();

Parameters

None.

Return value

A new object based on the MediaTrackSupportedConstraints dictionary listing the constraints supported by the user agent. Because only constraints supported by the user agent are included in the list, each of these Boolean properties has the value true.

Example

This example outputs a list of the constraints supported by your browser.

let constraintList = document.getElementById("constraintList");
let supportedConstraints = navigator.mediaDevices.getSupportedConstraints();

for (let constraint in supportedConstraints) {
  if (supportedConstraints.hasOwnProperty(constraint)) {
    let elem = document.createElement("li");
    
    elem.innerHTML = "<code>" + constraint + "</code>";
    constraintList.appendChild(elem);
  }
}

Result

Specifications

Specification Status Comment
Media Capture and Streams
The definition of 'getSupportedConstraints()' in that specification.
Candidate Recommendation Initial definition.

Browser compatibility

Update compatibility data on GitHub
DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidEdge MobileFirefox for AndroidOpera for AndroidiOS SafariSamsung Internet
Basic supportChrome Full support 53Edge ? Firefox Full support 44IE ? Opera Full support 40Safari Full support 11WebView Android Full support 53Chrome Android Full support 52Edge Mobile ? Firefox Android Full support 50Opera Android Full support 40Safari iOS Full support 11Samsung Internet Android ?

Legend

Full support  
Full support
Compatibility unknown  
Compatibility unknown

Document Tags and Contributors

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