MediaStreamTrack.getConstraints()

The getConstraints() method of the MediaStreamTrack interface returns a MediaTrackConstraints object containing the set of constraints most recently established for the track using a prior call to applyConstraints(). These constraints indicate values and ranges of values that the Web site or application has specified are acceptable for the included constrainable properties.

Constraints can be used to ensure that the media meets certain guidelines you prefer. For example, you may prefer high density video but require that the frame rate be a little low to help keep the data rate low enough not overtax the network. Constraints can also specify ideal and/or acceptable sizes or ranges of sizes. See "Capabilities and constraints" in Media Capture and Streams API (Media Streams) for details on how to work with constrainable properties.

Syntax

var constraints = MediaStreamTrack.getConstraints();

Parameters

None.

Return value

A MediaTrackConstraints object which indicates the constrainable properties the Web site or app most recently set using applyConstraints(). The properties in the returned object are listed in the same order as when they were set, and no properties not specifically set by the site or app are included.

Specifications

Browser compatibility