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.

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 Standard
The definition of 'AudioTrack.label' in that specification.
Living Standard Ā 
HTML5
The definition of 'AudioTrack.label' in that specification.
Recommendation Ā 

Browser compatibility

Update compatibility data on GitHub
DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidFirefox for AndroidOpera for AndroidSafari on iOSSamsung Internet
labelChrome ? Edge Full support 12Firefox ? IE ? Opera ? Safari Full support YesWebView Android ? Chrome Android ? Firefox Android ? Opera Android ? Safari iOS Full support YesSamsung Internet Android ?

Legend

Full support Ā 
Full support
Compatibility unknown Ā 
Compatibility unknown