{"json_modified": "2016-10-19T19:10:06.338728", "uuid": "97336a73-5830-402a-a5cb-514fe998f2a0", "title": "MediaTrackSettings.facingMode", "url": "/en-US/docs/Web/API/MediaTrackSettings/facingMode", "tags": ["API", "WebRTC", "MediaTrackSettings", "Reference", "Property", "Media Streams API", "Settings", "Video", "video", "Media Capture and Streams API", "Media", "facingMode"], "translations": [], "modified": "2016-10-19T19:10:06", "label": "MediaTrackSettings.facingMode", "localization_tags": [], "locale": "en-US", "id": 196787, "last_edit": "2016-10-19T19:09:59", "summary": "The <a href=\"/en-US/docs/Web/API/MediaTrackSettings\" title=\"The MediaTrackSettings dictionary is used to return the current values configured for each of a MediaStreamTrack's settings. These values will adhere as closely as possible to any constraints previously described using a MediaTrackConstraints object and set using applyConstraints(), and will adhere to the default constraints for any properties whose constraints haven't been changed, or whose customized constraints couldn't be matched.\"><code>MediaTrackSettings</code></a> dictionary's <code><strong>facingMode</strong></code> property is a <a href=\"/en-US/docs/Web/API/DOMString\" title=\"DOMString is a UTF-16 String. As JavaScript already uses such strings, DOMString is mapped directly to a String.\"><code>DOMString</code></a> indicating the direction in which the camera producing the video track represented by the <a href=\"/en-US/docs/Web/API/MediaStreamTrack\" title=\"The MediaStreamTrack interface represents&#xA0;a single media track within a stream; typically, these are audio or video tracks, but other track types may exist as well.\"><code>MediaStreamTrack</code></a> is currently facing. This lets you determine what value was selected to comply with your specified constraints for this property's value as described in the <a href=\"/en-US/docs/Web/API/MediaTrackConstraints/facingMode\" title=\"The MediaTrackConstraints dictionary's facingMode property is a ConstrainDOMString describing the requested or mandatory constraints placed upon the value of the facingMode constrainable property.\"><code>MediaTrackConstraints.facingMode</code></a> property you provided when calling either <a href=\"/en-US/docs/Web/API/MediaDevices/getUserMedia\" title=\"The MediaDevices.getUserMedia() method prompts the user for permission to use one video and/or one audio input device such as a camera or screensharing and/or a microphone. If the user provides permission, then the returned Promise is resolved with the resulting MediaStream object. If the user denies permission, or media is not available, then the promise is rejected with PermissionDeniedError or NotFoundError respectively. Note that it is possible for the returned promise to neither resolve nor reject, as the user is not required to make a choice.\"><code>getUserMedia()</code></a> or <a href=\"/en-US/docs/Web/API/MediaStreamTrack/applyConstraints\" title=\"The applyConstraints() method of the MediaStreamTrack interface applies a set of constraints to the track; these constraints let the Web site or app establish ideal values and acceptable ranges of values for the constrainable properties of the track, such as frame rate, dimensions, echo cancelation, and so forth.\"><code>MediaStreamTrack.applyConstraints()</code></a>.", "sections": [{"id": "Quick_Links", "title": null}, {"id": "Syntax", "title": "Syntax"}, {"id": "Value", "title": "Value"}, {"id": "VideoFacingModeEnum", "title": "VideoFacingModeEnum"}, {"id": "Example", "title": "Example"}, {"id": "Specifications", "title": "Specifications"}, {"id": "Browser_compatibility", "title": "Browser compatibility"}, {"id": "See_also", "title": "See also"}], "slug": "Web/API/MediaTrackSettings/facingMode", "review_tags": []}