Back to Content

MediaTrackSupportedConstraints: restrictOwnAudio property

files/en-us/web/api/mediatracksupportedconstraints/restrictownaudio/index.md

latest1.7 KB
Original Source

{{APIRef("Media Capture and Streams")}}{{SeeCompatTable}}

The {{domxref("MediaTrackSupportedConstraints")}} dictionary's restrictOwnAudio property is a read-only boolean value which is present (and set to true) in the object returned by {{domxref("MediaDevices.getSupportedConstraints()")}} if and only if the {{Glossary("user agent")}} supports the restrictOwnAudio 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 {{domxref("MediaDevices.getSupportedConstraints()", "navigator.mediaDevices.getSupportedConstraints()")}}.

Value

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

Examples

html
<div id="result"></div>
css
#result {
  font:
    14px "Arial",
    sans-serif;
}
js
const result = document.getElementById("result");
const supported =
  navigator.mediaDevices.getSupportedConstraints().restrictOwnAudio;
result.textContent = supported ? "Supported!" : "Not supported!";

Result

{{EmbedLiveSample('Examples', 600, 80)}}

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}

See also

  • Media Capture and Streams API
  • {{domxref("MediaDevices.getSupportedConstraints()")}}
  • {{domxref("MediaTrackSupportedConstraints")}}
  • {{domxref("MediaStreamTrack")}}