AudioTrackList.length

読み取り専用の AudioTrackList の length プロパティは、AudioTrackList 内のエントリ数を返します。各エントリは、メディア要素内の1つの音声トラックを表す AudioTrack です。値 0 は、メディアに音声トラックがないことを示します。

構文

var trackCount = AudioTrackList.length;

値

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

例

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

var videoElem = document.querySelector("video");
var numAudioTracks = 0;

if (videoElem.audioTracks) {
  numAudioTracks = videoElem.audioTracks.length;
}

このサンプルは、AudioTrack をサポートしていないブラウザーで失敗するのを避けるために、HTMLMediaElement.audioTracks が定義されていることを確認していることに注意してください。

仕様

仕様	状態	コメント
HTML Living Standard AudioTrackList.length の定義	現行の標準
HTML5 AudioTrackList.length の定義	勧告

ブラウザーの互換性

BCD tables only load in the browser