このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docsコミュニティーについてもっと知り、仲間になるにはこちらから。
MediaStream: active プロパティ
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2017年9月.
active はMediaStream インターフェイスの読み取り専用プロパティで、論理値を返します。ストリームが現在アクティブであればtrue 、それ以外の場合はfalse となります。MediaStreamTrack のうちMediaStreamTrack.readyState がended に設定されているトラックが 1 本でもある場合は、ストリームがアクティブであるとみなされます。すべでのトラックが終了すると、このストリームのactive プロパティはfalse になります。
値
論理値で、このストリームが現在アクティブな場合はtrue を返します。それ以外はfalse を返します。
例
この例では、getUserMedia() を用いて、要求されたユーザーのローカルのカメラとマイクをソースとする新しいストリームを取得します。ストリームが有効になると（ここでは、Promise が履行状態になった時）、ストリームが現在アクティブであるかどうかに応じてページにあるボタンの状態が更新されます。
js
const promise = navigator.mediaDevices.getUserMedia({ audio: true, video: true,});promise.then((stream) => { const startBtn = document.querySelector("#startBtn"); startBtn.disabled = stream.active;});仕様書
| Specification |
|---|
| Media Capture and Streams # dom-mediastream-active |