HTMLMediaElement: timeupdate event
The timeupdate
event is fired when the time indicated by the currentTime
attribute has been updated.
The event frequency is dependent on the system load, but will be thrown between about 4Hz and 66Hz (assuming the event handlers don't take longer than 250ms to run). User agents are encouraged to vary the frequency of the event based on the system load and the average cost of processing the event each time, so that the UI updates are not any more frequent than the user agent can comfortably handle while decoding the video.
This event is not cancelable and does not bubble.
Syntax
Use the event name in methods like addEventListener()
, or set an event handler property.
js
addEventListener("timeupdate", (event) => {});
ontimeupdate = (event) => {};
Event type
A generic Event
.
Examples
These examples add an event listener for the HTMLMediaElement's timeupdate
event, then post a message when that event handler has reacted to the event firing. Remember, the event frequency is dependent on the system load.
Using addEventListener()
:
js
const video = document.querySelector("video");
video.addEventListener("timeupdate", (event) => {
console.log("The currentTime attribute has been updated. Again.");
});
Using the ontimeupdate
event handler property:
js
const video = document.querySelector("video");
video.ontimeupdate = (event) => {
console.log("The currentTime attribute has been updated. Again.");
};
Specifications
Specification |
---|
HTML Standard # event-media-timeupdate |
HTML Standard # handler-ontimeupdate |
Browser compatibility
BCD tables only load in the browser
Related Events
- The HTMLMediaElement
playing
event - The HTMLMediaElement
waiting
event - The HTMLMediaElement
seeking
event - The HTMLMediaElement
seeked
event - The HTMLMediaElement
ended
event - The HTMLMediaElement
loadedmetadata
event - The HTMLMediaElement
loadeddata
event - The HTMLMediaElement
canplay
event - The HTMLMediaElement
canplaythrough
event - The HTMLMediaElement
durationchange
event - The HTMLMediaElement
timeupdate
event - The HTMLMediaElement
play
event - The HTMLMediaElement
pause
event - The HTMLMediaElement
ratechange
event - The HTMLMediaElement
volumechange
event - The HTMLMediaElement
suspend
event - The HTMLMediaElement
emptied
event - The HTMLMediaElement
stalled
event