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.
Syntax
var videoTrackLabel = VideoTrack.label;
Value
A DOMString
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."
.
Example
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.
function getTrackList(el) { var trackList = []; const wantedKinds = [ "main", "alternative", "commentary" ]; el.videoTracks.forEach(function(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 | Status | Comment |
---|---|---|
HTML Living Standard The definition of 'VideoTrack: label' in that specification. |
Living Standard |
Browser compatibility
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
label | Chrome
Full support
45
| Edge
Full support
79
| Firefox
Full support
33
| IE Full support 10 | Opera
Full support
32
| Safari Full support 6.1 | WebView Android Full support 45 | Chrome Android
Full support
45
| Firefox Android
Full support
33
| Opera Android
Full support
32
| Safari iOS Full support 7 | Samsung Internet Android No support No |
Legend
- Full support
- Full support
- No support
- No support
- User must explicitly enable this feature.
- User must explicitly enable this feature.