Web/API/MediaTrackSupportedConstraints/autoGainControl

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.

Syntax

autoGainSupported = supportedConstraintsDictionary.autoGainControl;

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.

Example

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

HTML content

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

CSS content

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

JavaScript content

let result = document.getElementById("result");

if (navigator.mediaDevices.getSupportedConstraints().autoGainControl) {
    result.innerHTML = "Supported!";
} else {
    result.innerHTML = "Not supported!";
}

Result

Specifications

Specification	Status	Comment
Media Capture and StreamsThe definition of 'autoGainControl' in that specification.	Candidate Recommendation	Initial specification.

Browser compatibility

Update compatibility data on GitHub

	Desktop						Mobile
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
`autoGainControl`	Chrome Full support 69	Edge Full support ≤79	Firefox Full support 55 Full support 55 No support ? — 55 Prefixed' Prefixed' Implemented with the vendor prefix: moz	IE No support No	Opera Full support Yes	Safari ?	WebView Android Full support 69	Chrome Android Full support 69	Firefox Android Full support 55 Full support 55 No support ? — 55 Prefixed' Prefixed' Implemented with the vendor prefix: moz	Opera Android Full support Yes	Safari iOS ?	Samsung Internet Android Full support 10.0

Legend

Full support: Full support
No support: No support
Compatibility unknown: Compatibility unknown
Requires a vendor prefix or different name for use.': Requires a vendor prefix or different name for use.