MediaTrackSupportedConstraints: autoGainControl property

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

See full compatibility

The MediaTrackSupportedConstraints dictionary's autoGainControl property is a read-only Boolean value which is present (and set to true) in the object returned by MediaDevices.getSupportedConstraints() if and only if the user agent supports the autoGainControl constraint. If the constraint isn't supported, it's not included in the list, so this value will never be false.

You can access the supported constraints dictionary by calling navigator.mediaDevices.getSupportedConstraints().

The autoGainControl constraint indicates whether or not the browser offers the ability to automatically control the gain (volume) on media tracks; this obviously is contingent on whether or not the individual device supports automatic gain control as well; it's typically a feature provided by microphones.

Value

This property is present in the dictionary (and its value is always true) if the user agent supports the autoGainControl constraint. If the property isn't present, this property is missing from the supported constraints dictionary, and you'll get undefined if you try to look at its value.

Examples

This example displays whether or not your browser supports the autoGainControl constraint.

<div id="result"></div>

#result {
  font:
    14px "Arial",
    sans-serif;
}

const result = document.getElementById("result");
const supported =
  navigator.mediaDevices.getSupportedConstraints().autoGainControl;
result.textContent = supported ? "Supported!" : "Not supported!";

Result

Specifications

Specification
Media Capture and Streams # dom-mediatrackconstraintset-autogaincontrol

Browser compatibility

	desktop					mobile
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox for Android	Opera Android	Safari on iOS	Samsung Internet	WebView Android	WebView on iOS
`autoGainControl` constraint	Chrome – Full support Chrome 67 (Release date: 2018-05-29) footnote Full support	Edge – Full support Edge 79 (Release date: 2020-01-15) footnote Full support	Firefox – Full support Firefox 46 (Release date: 2016-04-26) prefix prefix Implemented with the vendor prefix: moz Firefox – Full support Firefox 55 (Release date: 2017-08-08) footnote Full support	Opera – Full support Opera 54 (Release date: 2018-06-28) footnote Full support	Safari – No support Safari footnote No support	Chrome Android – Full support Chrome Android 67 (Release date: 2018-05-31) footnote Full support	Firefox for Android – Full support Firefox for Android 46 (Release date: 2016-04-26) prefix prefix Implemented with the vendor prefix: moz Firefox for Android – Full support Firefox for Android 55 (Release date: 2017-08-08) footnote Full support	Opera Android – Full support Opera Android 48 (Release date: 2018-11-08) footnote Full support	Safari on iOS – No support Safari on iOS footnote No support	Samsung Internet – Full support Samsung Internet 9 (Release date: 2018-09-15) footnote Full support	WebView Android – Full support WebView Android 67 (Release date: 2018-05-31) footnote Full support	WebView on iOS – No support WebView on iOS footnote No support

Tip: you can click/tap on a cell for more information.

Full support: Full support
No support: No support
: Requires a vendor prefix or different name for use.
: Has more compatibility info.