AudioTrackList.length

The read-only AudioTrackList property length returns the number of entries in the AudioTrackList, each of which is an AudioTrack representing one audio track in the media element. A value of 0 indicates that there are no audio tracks in the media.

Syntax

var trackCount = AudioTrackList.length;

Value

A number indicating how many audio tracks are included in the AudioTrackList. Each track can be accessed by treating the AudioTrackList as an array of objects of type AudioTrack.

Example

This snippet gets the number of audio tracks in the first <video> element found in the DOM by querySelector().

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

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

Note that this sample checks to be sure HTMLMediaElement.audioTracks is defined, to avoid failing on browsers without support for AudioTrack.

Specifications

Specification Status Comment
HTML Living Standard
The definition of 'AudioTrackList.length' in that specification.
Living Standard  
HTML5
The definition of 'AudioTrackList.length' in that specification.
Recommendation  

Browser compatibility

No compatibility data found. Please contribute data for "api.AudioTrackList.length" (depth: 1) to the MDN compatibility data repository.

Document Tags and Contributors

Contributors to this page: Sheppy
Last updated by: Sheppy,