/Web APIs


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

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.

DOMException OverconstrainedError



Creates a new OverconstrainedError object.

Instance properties

OverconstrainedError.constraint Read only

Returns the constraint that was supplied in the constructor, meaning the constraint that was not satisfied.

DOMException.message Read only

Returns the text supplied in the constructor.

DOMException.name Read only

Will always return OverconstrainedError.

Instance methods



Browser compatibility

Desktop Mobile
Chrome Edge Firefox Internet Explorer Opera Safari WebView Android Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet
OverconstrainedError 63 79 No No 50 11 63 63 No 46 11 8.0
OverconstrainedError 63 79 No No 50 11 63 63 No 46 11 8.0
constraint 63 79 No No 50 11.1 63 63 No 46 11.3 8.0

© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.