AudioTrack: label property
MDN Web Docs · نسخهٔ df622a2a1c1e · CC BY-SA 2.5 و مجوز جداگانهٔ ناشر برای نمونهکد
{{APIRef("HTML DOM")}}
The read-only {{domxref("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 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 {{domxref("AudioTrack.kind", "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) {
const trackList = [];
const wantedKinds = [
"main",
"alternative",
"main-desc",
"translation",
"commentary",
];
el.audioTracks.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 audio tracks whose kind is one of those in the array wantedKinds, with each entry providing the track's {{domxref("AudioTrack.id", "id")}}, {{domxref("AudioTrack.kind", "kind")}}, and label.
Specifications
{{Specifications}}
Browser compatibility
{{Compat}}