--- title: HTMLMediaElement.videoTracks slug: Web/API/HTMLMediaElement/videoTracks tags: - API - HTML DOM - HTMLMediaElement - Media - Property - Reference - Tracks - Video - Video Tracks - Web - videoTracks translation_of: Web/API/HTMLMediaElement/videoTracks ---
{{APIRef("HTML DOM")}}{{draft}}

{{DOMxRef("HTMLMediaElement")}} オブジェクトの読み取り専用の videoTracks プロパティは、メディア要素の動画トラックを表すすべての {{DOMxRef("VideoTrack")}} オブジェクトを列挙した {{DOMxRef("VideoTrackList")}} オブジェクトを返します。

返されたリストはライブです。 つまり、トラックがメディア要素に追加されたり取り除かれたりすると、リストの内容は動的に変化します。 リストへの参照を取得したら、新しい動画トラックが追加されたのか既存のトラックが取り除かれたのかを検出するために変更を監視できます。 メディア要素のトラックリストへの変更を監視する方法の詳細については、{{DOMxRef("VideoTrackList")}} のイベントハンドラを参照してください。

構文

var videoTracks = mediaElement.videoTracks;

メディア要素に含まれる動画トラックのリストを表す {{DOMxRef("VideoTrackList")}} オブジェクト。 トラックのリストは、配列記法や、オブジェクトの {{domxref("VideoTrackList.getTrackById", "getTrackById()")}} メソッドを使ってアクセスできます。

各トラックは、トラックに関する情報を提供する {{DOMxRef("VideoTrack")}} オブジェクトによって表されます。

仕様

仕様 状態 コメント
{{SpecName("HTML WHATWG", "#dom-media-videotracks", "HTMLMediaElement.videoTracks")}} {{Spec2("HTML WHATWG")}} {{SpecName('HTML5 W3C')}} から変更なし

ブラウザーの対応

{{Compat("api.HTMLMediaElement.videoTracks")}}

関連情報