VideoTrackList.length

読み取り専用の VideoTrackList の length プロパティは、VideoTrackList 内の項目数を返します。 各項目は、メディア要素内の 1 つの映像トラックを表す VideoTrack です。

値 0 は、メディアに映像トラックがないことを示します。

値

VideoTrackList に含まれる映像トラック数を示す数値。 VideoTrackList を VideoTrack 型のオブジェクトの配列として扱うことで、各トラックにアクセスできます。

例

このスニペットは、 DOM 内で見つかった最初の <video> 要素内の映像トラックの数を querySelector() によって取得します。

js
const videoElem = document.querySelector("video");
let numVideoTracks = 0;

if (videoElem.videoTracks) {
  numVideoTracks = videoElem.videoTracks.length;
}

この例は、VideoTrack に対応していないブラウザーで落ちるのを避けるために、HTMLMediaElement.videoTracks が定義されていることを確認していることに注意してください。

仕様書

Specification
HTML Standard
# dom-videotracklist-length-dev

ブラウザーの互換性

BCD tables only load in the browser