--- title: active slug: Web/API/MediaStream/active translation_of: Web/API/MediaStream/active ---

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

{{domxref("MediaStream")}}インタフェースのactiveは読み取り専用のプロパティであり、ストリームが現在アクティブであればtrueを返し、それ以外の場合はfalseを返します。少なくとも一つのトラックの状態が{{domxref("MediaStreamTrack.ended")}}でない場合、ストリームがアクティブであるとみなされます。すべでのトラックが終了すると、このストリームのactiveプロパティはfalseになります。

文法

var isActive = MediaStream.active;

このストリームが現在アクティブな場合はtrueを返します。それ以外はfalseを返します。

この例では、{{domxref("MediaDevices.getUserMedia", "getUserMedia()")}}を用いて、要求されたユーザーのローカルのカメラとマイクロフォンをソースとする新しいストリームを取得しています。ストリームが有効になると(ここでは、{{jsxref("Promise")}}がfulfilledの状態になった時)、ストリームが現在アクティブであるかどうかに応じてページにあるボタンの状態が更新されます。

var promise = navigator.mediaDevices.getUserMedia({
  audio: true,
  video: true
});

promise.then(function(stream) {
  var startBtn = document.querySelector('#startBtn');
  startBtn.disabled = stream.active;
});

仕様

仕様 状況 コメント
{{SpecName('Media Capture', '#widl-MediaStream-active', 'active')}} {{Spec2('Media Capture')}} 初版

ブラウザ互換性

{{CompatibilityTable}}

Feature Chrome Firefox (Gecko) Microsoft Edge Internet Explorer Opera Safari (WebKit)
Basic support {{CompatVersionUnknown}} {{CompatGeckoDesktop(52)}} {{CompatUnknown}} {{CompatUnknown}} {{CompatUnknown}} {{CompatUnknown}}
Feature Android Android Webview Firefox Mobile (Gecko) Firefox OS IE Mobile Opera Mobile Safari Mobile Chrome for Android
Basic support {{CompatNo}} {{CompatVersionUnknown}} {{CompatGeckoMobile(52)}} {{CompatUnknown}} {{CompatUnknown}} {{CompatUnknown}} {{CompatUnknown}} {{CompatVersionUnknown}}