MediaStreamTrack.getSettings()

The getSettings() method of the MediaStreamTrack interface returns a MediaTrackSettings object containing the current values of each of the constrainable properties for the current MediaStreamTrack. See Capabilities, constraints, and settings for details on how to work with constrainable properties.

Syntax

var settings = MediaStreamTrack.getSettings();

Parameters

None.

Returns

MediaTrackSettings object describing the current configuration of the track's constrainable properties.

The returned object identifies the current values of every constrainable property, including those which are platform defaults rather than having been expressly set by the site's code. To instead fetch the most-recently established constraints for the track's properties, as specified by the site's code, use getConstraints().

Specifications

Specification Status Comment
Media Capture and Streams
The definition of 'getSettings()' in that specification.
Candidate Recommendation Initial definition.

Browser compatibility

Update compatibility data on GitHub
DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidEdge MobileFirefox for AndroidOpera for AndroidSafari on iOSSamsung Internet
Basic supportChrome Full support 61Edge Full support 12Firefox Full support 50IE ? Opera Full support 48Safari ? WebView Android Full support 61Chrome Android Full support 61Edge Mobile ? Firefox Android Full support 50Opera Android Full support 48Safari iOS Full support 11Samsung Internet Android No support No

Legend

Full support  
Full support
No support  
No support
Compatibility unknown  
Compatibility unknown

Document Tags and Contributors

Contributors to this page: fscholz, ThorstenBux, jpmedley, ChibiDenDen, Sheppy
Last updated by: fscholz,