The ConstrainLong type is used to specify a constraint for a property whose value is an integral number. It extends the LongRange 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.


If the value of a ConstrainLong is an object rather than a number, it may have the properties below in addition to the properties it inherits from LongRange.

An integer specifying precise, required, value the property must have to be considered acceptable.
An integer specifying a value the property would ideally have, but which can be considered optional if necessary to find a match.


Specification Status Comment
Media Capture and Streams
The definition of 'ConstrainLong' in that specification.
Editor's Draft Initial definition

Technically, ConstrainLong is actually based on an intermediary dictionary named ConstrainLongRange, which adds exact and ideal to LongRange, with ConstrainLong being a type that can be either a long integer or a LongRange. However, for the sake of documentation clarity, the intermediate type (present only because of quirks in WebIDL syntax) is ignored here.

Browser compatibility

Feature Chrome Firefox (Gecko) Internet Explorer Microsoft Edge Opera Safari (WebKit)
Basic support (Yes) 50 (50) No support ? No support ?
Feature Android Android Webview Firefox Mobile (Gecko) IE Phone Opera Mobile Safari Mobile Chrome for Android
Basic support ? (Yes) 50.0 (50) No support No support ? (Yes)

See also

Document Tags and Contributors

 Contributors to this page: Sheppy
 Last updated by: Sheppy,