The cuechange
event fires when a TextTrack
has changed the currently displaying cues. The event is fired on both the TextTrack
and the HTMLTrackElement
in which it's being presented, if any.
On this page
TextTrack: cuechange event
Syntax
Use the event name in methods like addEventListener()
, or set an event handler property.
js
addEventListener("cuechange", (event) => {});
oncuechange = (event) => {};
Event type
A generic Event
with no added properties.
Examples
You can set up a listener for the cuechange
event on a TextTrack
using the addEventListener()
method:
js
track.addEventListener("cuechange", () => {
const cues = track.activeCues; // array of current cues
// …
});
Or you can set the oncuechange
event handler property:
js
track.oncuechange = (event) => {
let cues = track.activeCues; // array of current cues
};
Specifications
Browser compatibility
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | |
cuechange_event |
23 | 12 | 31 | 10 | ≤12.1 | 6 | 4.4 | 25 | 31 | ≤12.1 | 7 | 1.5 |
See also
- WebVTT
- The same event on
HTMLTrackElement
:cuechange
© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/TextTrack/cuechange_event