W3cubDocs

/Web APIs

VideoTrackList: length property

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

Browser compatibility

Desktop Mobile
Chrome Edge Firefox Internet Explorer Opera Safari WebView Android Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet
length 37 7912–79 33 10 24 7 No 37 No No 7 No

© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/VideoTrackList/length