AudioTrack.label
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.
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"
.
Examples
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 |
---|
HTML Standard # dom-audiotrack-label-dev |
Browser compatibility
BCD tables only load in the browser