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 が定義されていることを確認していることに注意してください。

仕様

Specification
HTML Standard
# dom-audiotracklist-length-dev

ブラウザーの互換性

BCD tables only load in the browser