AudioTrackList: change event

فهرست فصل‌ها دانلود آرشیوناشر

MDN Web Docs · نسخهٔ df622a2a1c1e · CC BY-SA 2.5 و مجوز جداگانهٔ ناشر برای نمونه‌کد

{{APIRef("HTML DOM")}}

The change event is fired when an audio track is enabled or disabled, for example by changing the track's [enabled](/en-US/docs/Web/API/AudioTrack/enabled) property.

This event is not cancelable and does not bubble.

Syntax

Use the event name in {{domxref("EventTarget/addEventListener", "addEventListener()")}}:

js-nolint
addEventListener("change", (event) => { })

Alternatively, assign to the event handler property of the interface:

js-nolint
onchange = (event) => { }

Event type

A generic {{domxref("Event")}}.

Examples

Using addEventListener():

js
const videoElement = document.querySelector("video");
videoElement.audioTracks.addEventListener("change", (event) => {
  console.log(`'${event.type}' event fired`);
});

// changing the value of `enabled` will trigger the `change` event
const toggleTrackButton = document.querySelector(".toggle-track");
toggleTrackButton.addEventListener("click", () => {
  const track = videoElement.audioTracks[0];
  track.enabled = !track.enabled;
});

Using the onchange event handler property (but note that this replaces other event listeners added using onchange, if any):

js
const videoElement = document.querySelector("video");
videoElement.audioTracks.onchange = (event) => {
  console.log(`'${event.type}' event fired`);
};

// changing the value of `enabled` will trigger the `change` event
const toggleTrackButton = document.querySelector(".toggle-track");
toggleTrackButton.addEventListener("click", () => {
  const track = videoElement.audioTracks[0];
  track.enabled = !track.enabled;
});

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}

See also

  • Related events: [addtrack](/en-US/docs/Web/API/AudioTrackList/addtrack_event), [removetrack](/en-US/docs/Web/API/AudioTrackList/removetrack_event)
  • This event on [VideoTrackList](/en-US/docs/Web/API/VideoTrackList) targets: [change](/en-US/docs/Web/API/VideoTrackList/change_event)
  • Media Capture and Streams API
  • WebRTC API