| title | short-title | slug | page-type | browser-compat |
|---|---|---|---|---|
MediaTrackSettings: height property |
height |
Web/API/MediaTrackSettings/height |
web-api-instance-property |
api.MediaStreamTrack.applyConstraints.height_constraint |
{{APIRef("Media Capture and Streams")}}
The {{domxref("MediaTrackSettings")}} dictionary's height
property is an integer indicating the number of pixels tall
{{domxref("MediaStreamTrack")}} is currently configured to be. This lets you determine
what value was selected to comply with your specified constraints for this property's
value as described in the {{domxref("MediaTrackConstraints.height")}} property you
provided when calling either {{domxref("MediaDevices.getUserMedia", "getUserMedia()")}}
or {{domxref("MediaStreamTrack.applyConstraints()")}}.
If needed, you can determine whether or not this constraint is supported by checking the value of {{domxref("MediaTrackSupportedConstraints.height")}} as returned by a call to {{domxref("MediaDevices.getSupportedConstraints()")}}. However, typically this is unnecessary since browsers will ignore any constraints they're unfamiliar with.
An integer value indicating the height, in pixels, of the video track as currently configured.
See the Constraint exerciser example.
{{Specifications}}
{{Compat}}
- Media Capture and Streams API
- Capabilities, constraints, and settings
- {{domxref("MediaTrackConstraints.height")}}
- {{domxref("MediaTrackSettings")}}