--- title: MediaDevices.getSupportedConstraints() slug: Web/API/MediaDevices/getSupportedConstraints translation_of: Web/API/MediaDevices/getSupportedConstraints ---

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

{{domxref("MediaDevices")}} インタフェースのgetSupportedConstraints() メソッドは、{{domxref("MediaTrackSupportedConstraints")}}ディクショナリをベースとするオブジェクトを戻り値として返します。このオブジェクトのメンバーフィールドは、{{Glossary("user agent")}}が扱えるメディア制約に関するプロパティを表しています。

文法

var supportedConstraints = navigator.mediaDevices.getSupportedConstraints();

パラメータ

なし。

戻り値

{{domxref("MediaTrackSupportedConstraints")}}ディクショナリをベースにした新しいオブジェクトです。このオブジェクトはユーザエージェントが扱えるメディア制約の一覧を含みます。この一覧に含まれているものはユーザエージェントが取り扱えるものだけなので、全てのBoolean型のプロパティはtrueの値になっています。

この例は、実行中のブラウザでサポートされている制約の一覧を出力するものです。

let constraintList = document.getElementById("constraintList");
let supportedConstraints = navigator.mediaDevices.getSupportedConstraints();

for (let constraint in supportedConstraints) {
  if (supportedConstraints.hasOwnProperty(constraint)) {
    let elem = document.createElement("li");

    elem.innerHTML = "<code>" + constraint + "</code>";
    constraintList.appendChild(elem);
  }
}

実行結果

{{ EmbedLiveSample('Example', 600, 350) }}

仕様

仕様 状態 コメント
{{SpecName('Media Capture', '#widl-MediaDevices-getSupportedConstraints-MediaTrackSupportedConstraints', 'getSupportedConstraints()')}} {{Spec2('Media Capture')}} 初版

ブラウザ互換性

{{Compat("api.MediaDevices.getSupportedConstraints")}}