The read-only AudioTrack
property label
returns a string specifying the audio track's human-readable label, if one is available; otherwise, it returns an empty string.
Syntax
var audioTrackLabel = AudioTrack.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 "commentary"
might have a label
such as "Commentary with director Mark Markmarkimark and star Donna Donnalidon"
.
Example
This example returns an array of track kinds and labels for potential use in a user interface to select audio 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", "main-desc", "translation", "commentary"
];
el.audioTracks.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 audio 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 'AudioTrack.label' in that specification. | Living Standard | |
HTML5The definition of 'AudioTrack.label' in that specification. | Recommendation |
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.
AudioTrack.label by Mozilla Contributors is licensed under CC-BY-SA 2.5.