OverconstrainedError

Secure context
This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.

This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

The OverconstrainedError interface of the Media Capture and Streams API indicates that the set of desired capabilities for the current MediaStreamTrack cannot currently be met. When this event is thrown on a MediaStreamTrack, it is muted until either the current constraints can be established or until satisfiable constraints are applied.

Constructor

OverconstrainedError.OverconstrainedError()
Creates a new OverconstrainedError object.

Properties

OverconstrainedError.constraint Read only
Returns the constraint that was supplied in the constructor, meaning the constraint that was not satisfied.
OverconstrainedError.message Read only
Returns the text supplied in the constructor.
OverconstrainedError.name Read only
Will always return OverconstrainedError.

Methods

None.

Specifications

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

Browser compatibility

Update compatibility data on GitHub
DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidEdge MobileFirefox for AndroidOpera for AndroidSafari on iOSSamsung Internet
Basic support
Experimental
Chrome Full support 63Edge ? Firefox ? IE ? Opera Full support 50Safari ? WebView Android Full support 63Chrome Android Full support 63Edge Mobile ? Firefox Android ? Opera Android Full support 50Safari iOS ? Samsung Internet Android ?
OverconstrainedError() constructor
Experimental
Chrome Full support 63Edge ? Firefox ? IE ? Opera Full support 50Safari ? WebView Android Full support 63Chrome Android Full support 63Edge Mobile ? Firefox Android ? Opera Android Full support 50Safari iOS ? Samsung Internet Android ?
name
Experimental
Chrome Full support 63Edge ? Firefox ? IE ? Opera Full support 50Safari ? WebView Android Full support 63Chrome Android Full support 63Edge Mobile ? Firefox Android ? Opera Android Full support 50Safari iOS ? Samsung Internet Android ?
message
Experimental
Chrome Full support 63Edge ? Firefox ? IE ? Opera Full support 50Safari ? WebView Android Full support 63Chrome Android Full support 63Edge Mobile ? Firefox Android ? Opera Android Full support 50Safari iOS ? Samsung Internet Android ?
constraint
Experimental
Chrome Full support 63Edge ? Firefox ? IE ? Opera Full support 50Safari ? WebView Android Full support 63Chrome Android Full support 63Edge Mobile ? Firefox Android ? Opera Android Full support 50Safari iOS ? Samsung Internet Android ?

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: mdnwebdocs-bot, jpmedley
Last updated by: mdnwebdocs-bot,