The {{domxref("MediaTrackConstraints")}} dictionary's facingMode
property is a {{domxref("ConstrainDOMString")}} describing the requested or mandatory constraints placed upon the value of the {{domxref("MediaTrackSettings.facingMode", "facingMode")}} constrainable property.
If needed, you can determine whether or not this constraint is supported by checking the value of {{domxref("MediaTrackSupportedConstraints.facingMode")}} as returned by a call to {{domxref("MediaDevices.getSupportedConstraints()")}}. However, typically this is unnecessary since browsers will simply ignore any constraints they're unfamiliar with.
Syntax
var constraintsObject = { facingMode: constraint }; constraintsObject.facingMode = constraint;
Value
An object based on {{domxref("ConstrainDOMString")}} specifying one or more acceptable, ideal, and/or exact (mandatory) facing modes are acceptable for a video track.
An exact
value in this case indicates that the specified facing mode is specifically required; for example:
var constraints = { facingMode: { exact: "user" } };
This indicates that only a user-facing camera is acceptable; if there is no user-facing camera, or the user declines permission to use that camera, the media request will fail.
Example
See {{SectionOnPage("/en-US/docs/Web/API/Media_Streams_API/Constraints", "Example: Constraint exerciser")}} for an example.
Specifications
Specification | Status | Comment |
---|---|---|
{{ SpecName('Media Capture', '#widl-MediaTrackConstraints-facingMode', 'facingMode') }} | {{ Spec2('Media Capture') }} | Initial specification. |
Browser compatibility
{{CompatibilityTable}}
Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|
Basic support | {{CompatVersionUnknown}} | {{ CompatGeckoDesktop(50) }} | {{CompatNo}} | {{CompatVersionUnknown}} | {{CompatUnknown}} |
Feature | Android | Android Webview | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile | Chrome for Android |
---|---|---|---|---|---|---|---|
Basic support | {{CompatUnknown}} | {{CompatVersionUnknown}} | {{ CompatGeckoMobile(50) }} | {{CompatNo}} | {{CompatUnknown}} | {{CompatUnknown}} | {{CompatVersionUnknown}} |
See also
- Media Capture and Streams API
- Capabilities, constraints, and settings
- {{domxref("MediaTrackConstraints")}}
- {{domxref("MediaDevices.getSupportedConstraints()")}}
- {{domxref("MediaTrackSupportedConstraints")}}
- {{domxref("MediaStreamTrack")}}