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
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.
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
OverconstrainedError | 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 | 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 | 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 | 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 | 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.