OverconstrainedError

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

See full compatibility

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(): Creates a new OverconstrainedError object.

Instance properties

Also inherits properties from its parent interface, DOMException.

OverconstrainedError.constraint Read only: Returns the constraint that was supplied in the constructor, meaning the constraint that was not satisfied.

Instance methods

Also inherits methods from its parent interface, DOMException.

Specifications

Specification
Media Capture and Streams # overconstrainederror-interface

Browser compatibility

	desktop					mobile
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox for Android	Opera Android	Safari on iOS	Samsung Internet	WebView Android	WebView on iOS
`OverconstrainedError`	Chrome – Full support Chrome 63 (Release date: 2017-12-06) footnote Full support	Edge – Full support Edge 79 (Release date: 2020-01-15) footnote Full support	Firefox – No support Firefox footnote No support	Opera – Full support Opera 50 (Release date: 2018-01-04) footnote Full support	Safari – Full support Safari 11 (Release date: 2017-09-19) footnote Full support	Chrome Android – Full support Chrome Android 63 (Release date: 2017-12-05) footnote Full support	Firefox for Android – No support Firefox for Android footnote No support	Opera Android – Full support Opera Android 46 (Release date: 2018-05-14) footnote Full support	Safari on iOS – Full support Safari on iOS 11 (Release date: 2017-09-19) footnote Full support	Samsung Internet – Full support Samsung Internet 8 (Release date: 2018-07-18) footnote Full support	WebView Android – Full support WebView Android 63 (Release date: 2017-12-05) footnote Full support	WebView on iOS – Full support WebView on iOS 11 (Release date: 2017-09-19) footnote Full support
`OverconstrainedError()` constructor	Chrome – Full support Chrome 63 (Release date: 2017-12-06) footnote Full support	Edge – Full support Edge 79 (Release date: 2020-01-15) footnote Full support	Firefox – No support Firefox footnote No support	Opera – Full support Opera 50 (Release date: 2018-01-04) footnote Full support	Safari – Full support Safari 11 (Release date: 2017-09-19) footnote Full support	Chrome Android – Full support Chrome Android 63 (Release date: 2017-12-05) footnote Full support	Firefox for Android – No support Firefox for Android footnote No support	Opera Android – Full support Opera Android 46 (Release date: 2018-05-14) footnote Full support	Safari on iOS – Full support Safari on iOS 11 (Release date: 2017-09-19) footnote Full support	Samsung Internet – Full support Samsung Internet 8 (Release date: 2018-07-18) footnote Full support	WebView Android – Full support WebView Android 63 (Release date: 2017-12-05) footnote Full support	WebView on iOS – Full support WebView on iOS 11 (Release date: 2017-09-19) footnote Full support
`constraint`	Chrome – Full support Chrome 63 (Release date: 2017-12-06) footnote Full support	Edge – Full support Edge 79 (Release date: 2020-01-15) footnote Full support	Firefox – No support Firefox footnote No support	Opera – Full support Opera 50 (Release date: 2018-01-04) footnote Full support	Safari – Full support Safari 11.1 (Release date: 2018-04-12) footnote Full support	Chrome Android – Full support Chrome Android 63 (Release date: 2017-12-05) footnote Full support	Firefox for Android – No support Firefox for Android footnote No support	Opera Android – Full support Opera Android 46 (Release date: 2018-05-14) footnote Full support	Safari on iOS – Full support Safari on iOS 11.3 (Release date: 2018-03-29) footnote Full support	Samsung Internet – Full support Samsung Internet 8 (Release date: 2018-07-18) footnote Full support	WebView Android – Full support WebView Android 63 (Release date: 2017-12-05) footnote Full support	WebView on iOS – Full support WebView on iOS 11.3 (Release date: 2018-03-29) footnote Full support

Tip: you can click/tap on a cell for more information.

Full support: Full support
No support: No support

This page was last modified on Dec 17, 2023 by MDN contributors.

Visit Mozilla Corporation’s not-for-profit parent, the Mozilla Foundation.
Portions of this content are ©1998–2026 by individual mozilla.org contributors. Content available under a Creative Commons license.