Web/API/OverconstrainedError

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

This is an experimental technologyCheck 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 StreamsThe definition of 'OverconstrainedError' in that specification.	Candidate Recommendation	Initial definition.

Browser compatibility

The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.

Update compatibility data on GitHub

	Desktop						Mobile
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
OverconstrainedError Experimental'	Chrome Full support 63	Edge Full support ≤79	Firefox ?	IE ?	Opera Full support 50	Safari ?	WebView Android Full support 63	Chrome Android Full support 63	Firefox Android ?	Opera Android Full support 46	Safari iOS ?	Samsung Internet Android Full support 8.0
OverconstrainedError() constructor Experimental'	Chrome Full support 63	Edge Full support ≤79	Firefox ?	IE ?	Opera Full support 50	Safari ?	WebView Android Full support 63	Chrome Android Full support 63	Firefox Android ?	Opera Android Full support 46	Safari iOS ?	Samsung Internet Android Full support 8.0
constraint Experimental'	Chrome Full support 63	Edge Full support ≤79	Firefox ?	IE ?	Opera Full support 50	Safari ?	WebView Android Full support 63	Chrome Android Full support 63	Firefox Android ?	Opera Android Full support 46	Safari iOS ?	Samsung Internet Android Full support 8.0
message Experimental'	Chrome Full support 63	Edge Full support ≤79	Firefox ?	IE ?	Opera Full support 50	Safari ?	WebView Android Full support 63	Chrome Android Full support 63	Firefox Android ?	Opera Android Full support 46	Safari iOS ?	Samsung Internet Android Full support 8.0
name Experimental'	Chrome Full support 63	Edge Full support ≤79	Firefox ?	IE ?	Opera Full support 50	Safari ?	WebView Android Full support 63	Chrome Android Full support 63	Firefox Android ?	Opera Android Full support 46	Safari iOS ?	Samsung Internet Android Full support 8.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.

OverconstrainedError by Mozilla Contributors is licensed under CC-BY-SA 2.5.