-
Notifications
You must be signed in to change notification settings - Fork 22.4k
/
index.md
70 lines (48 loc) · 2.07 KB
/
index.md
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
---
title: "HTMLMediaElement: audioTracks property"
short-title: audioTracks
slug: Web/API/HTMLMediaElement/audioTracks
page-type: web-api-instance-property
browser-compat: api.HTMLMediaElement.audioTracks
---
{{APIRef("HTML DOM")}}
The read-only **`audioTracks`**
property on {{domxref("HTMLMediaElement")}} objects returns
an {{domxref("AudioTrackList")}} object listing all of the {{domxref("AudioTrack")}}
objects representing the media element's audio tracks.
The media element may be
either an {{HTMLElement("audio")}} element or a {{HTMLElement("video")}} element.
The returned list is _live_; that is, as tracks are added to and removed from
the media element, the list's contents change dynamically. Once you have a reference to
the list, you can monitor it for changes to detect when new audio tracks are added or
existing ones removed. See [AudioTrackList events](/en-US/docs/Web/API/AudioTrackList#events)
to learn more about watching for changes to a media element's track list.
## Value
An {{domxref("AudioTrackList")}} object representing the list of audio tracks included
in the media element. The list of tracks can be accessed using array notation, or using
the object's {{domxref("AudioTrackList.getTrackById", "getTrackById()")}} method.
Each track is represented by an {{domxref("AudioTrack")}} object which provides
information about the track.
## Examples
In this example, all of the audio tracks on a given element are muted.
### HTML
The HTML establishes the element itself.
```html
<video id="video" src="somevideo.mp4"></video>
```
### JavaScript
The JavaScript code handles muting the video element's audio tracks.
```js
const video = document.getElementById("video");
for (let i = 0; i < video.audioTracks.length; i += 1) {
video.audioTracks[i].enabled = false;
}
```
## Specifications
{{Specifications}}
## Browser compatibility
{{Compat}}
## See also
- {{domxref("HTMLMediaElement")}}: Interface used to define the `HTMLMediaElement.audioTracks` property
- {{HTMLElement("audio")}}, {{HTMLElement("video")}}
- {{domxref("AudioTrack")}}, {{domxref("AudioTrackList")}}