VideoTrackList: length property

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

The read-only VideoTrackList property length returns the number of entries in the VideoTrackList, each of which is a VideoTrack representing one video track in the media element.

A value of 0 indicates that there are no video tracks in the media.

Value

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

Examples

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

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

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

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

Specifications

Specification
HTML
# dom-videotracklist-length-dev

Browser compatibility

desktop mobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
length
Chrome – No support
Chrome 37 (Release date: 2014-08-26)
disabled
disabled From version 37 users must explicitly set the enable-experimental-web-platform-features preference to enabled. To change preferences in Chrome, visit chrome://flags.
Edge – No support
Edge 12 – 18 (Release date: 2015-07-29)
unknown Support unknown
Edge – No support
Edge 79 (Release date: 2020-01-15)
disabled
disabled From version 79 users must explicitly set the enable-experimental-web-platform-features preference to enabled. To change preferences in Edge, visit about:flags.
Firefox – No support
Firefox 33 (Release date: 2014-10-14)
disabled
disabled From version 33 users must explicitly set the media.track.enabled preference to true. To change preferences in Firefox, visit about:config.
Opera – No support
Opera 24 (Release date: 2014-09-02)
disabled
disabled From version 24 users must explicitly set the enable-experimental-web-platform-features preference to enabled. To change preferences in Opera, visit opera://flags.
Safari – Full support
Safari 7 (Release date: 2013-10-22)
footnote Full support
Chrome Android – No support
Chrome Android 37 (Release date: 2014-09-03)
disabled
disabled From version 37 users must explicitly set the enable-experimental-web-platform-features preference to enabled. To change preferences in Chrome Android, visit chrome://flags.
Firefox for Android – No support
Firefox for Android
footnote No support
Opera Android – No support
Opera Android
footnote No support
Safari on iOS – Full support
Safari on iOS 7 (Release date: 2013-09-18)
footnote Full support
Samsung Internet – No support
Samsung Internet
footnote No support
WebView Android – No support
WebView Android
footnote No support
WebView on iOS – Full support
WebView on iOS 7 (Release date: 2013-09-18)
footnote Full support

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support
User must explicitly enable this feature.
Has more compatibility info.