VideoTrack: label property
The read-only VideoTrack
property label
returns a string specifying the video
track's human-readable label, if one is available; otherwise, it returns an empty
string.
Value
A string specifying the track's human-readable label, if one is
available in the track metadata. Otherwise, an empty string (""
) is
returned.
For example, a track whose kind
is
"sign"
might have a label
such as
"A sign-language interpretation."
.
Examples
This example returns an array of track kinds and labels for potential use in a user interface to select video tracks for a specified media element. The list is filtered to only allow certain track kinds through.
js
function getTrackList(el) {
const trackList = [];
const wantedKinds = ["main", "alternative", "commentary"];
el.videoTracks.forEach((track) => {
if (wantedKinds.includes(track.kind)) {
trackList.push({
id: track.id,
kind: track.kind,
label: track.label,
});
}
});
return trackList;
}
The resulting trackList
contains an array of video tracks whose
kind
is one of those in the array wantedKinds
, with each entry
providing the track's id
, kind
, and label
.
Specifications
Specification |
---|
HTML Standard # dom-videotrack-label-dev |
Browser compatibility
BCD tables only load in the browser