The ConstrainULong type is used to specify a constraint for a property whose value is an integral number. It extends the ULongRange dictionary (which provides the ability to specify a permitted range of property values) to also support an exact value and/or an ideal value the property should take on. In addition, you can specify the value as a simple long integer value, in which case the user agent does its best to match the value once all other more stringent constraints are met.
Properties
If the value of a ConstrainULong is an object rather than a number, it may have the properties below in addition to the properties it inherits from ULongRange.
exact- An integer specifying precise, required, value the property must have to be considered acceptable.
ideal- An integer specifying a value the property would ideally have, but which can be considered optional if necessary to find a match.
Specifications
| Specification | Status | Comment |
| Media Capture and StreamsThe definition of 'ConstrainULong' in that specification. | Candidate Recommendation | Initial definition |
Technically, ConstrainULong is actually based on an intermediary dictionary named ConstrainULongRange, which adds exact and ideal to ULongRange, with ConstrainULong being a type that can be either a long integer or a ULongRange. However, for the sake of documentation clarity, the intermediate type (present only because of quirks in WebIDL syntax) is ignored here.
Browser compatibility
The compatibility table on 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 | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
ConstrainULong
|
Chrome
No support No |
Edge
No support No |
Firefox
No support No |
IE
No support No |
Opera
No support No |
Safari
No support No |
WebView Android
No support No |
Chrome Android
No support No |
Firefox Android
No support No |
Opera Android
No support No |
Safari iOS
No support No |
Samsung Internet Android
No support No |
Legend
- No support
- No support
See also
- Media Capture and Streams API
- Capabilities, constraints, and settings
ULongRangeMediaTrackConstraintsMediaTrackCapabilitiesMediaTrackSupportedConstraints
ConstrainULong by Mozilla Contributors is licensed under CC-BY-SA 2.5.
