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 StandardThe definition of 'VideoTrack: label' in that specification. | Living Standard |
Browser compatibility
The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Update compatibility data on GitHub
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
label
|
Chrome Full support 37 Full support 37 Disabled' From version 37: this feature is behind the |
Edge Full support 79 Full support 79 Disabled' From version 79: this feature is behind the |
Firefox Full support 33 Full support 33 Disabled' From version 33: this feature is behind the |
IE
Full support 10 |
Opera Full support 24 Full support 24 Disabled' From version 24: this feature is behind the |
Safari
Full support 6.1 |
WebView Android
No support No |
Chrome Android Full support 37 Full support 37 Disabled' From version 37: this feature is behind the |
Firefox Android Full support 33 Full support 33 Disabled' From version 33: this feature is behind the |
Opera Android Full support 24 Full support 24 Disabled' From version 24: this feature is behind the |
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.
VideoTrack.label by Mozilla Contributors is licensed under CC-BY-SA 2.5.