HTMLMediaElement: timeupdate Ereignis

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Das timeupdate Ereignis wird ausgelöst, wenn die durch das currentTime Attribut angegebene Zeit aktualisiert wurde.

Die Häufigkeit des Ereignisses hängt von der Systemlast ab, wird jedoch zwischen etwa 4Hz und 66Hz ausgelöst (vorausgesetzt, die Ereignishandler benötigen nicht länger als 250ms zur Ausführung). Es wird empfohlen, dass Benutzeragenten die Frequenz des Ereignisses abhängig von der Systemlast und den durchschnittlichen Kosten der Ereignisverarbeitung jedes Mal variieren, sodass die UI-Aktualisierungen nicht häufiger erfolgen, als es der Benutzeragent beim Dekodieren des Videos bequem handhaben kann.

Dieses Ereignis kann nicht abgebrochen werden und wird nicht gebubbelt.

Syntax

Verwenden Sie den Ereignisnamen in Methoden wie addEventListener() oder setzen Sie eine Event-Handler-Eigenschaft.

js
addEventListener("timeupdate", (event) => {});

ontimeupdate = (event) => {};

Ereignistyp

Ein generisches Event.

Beispiele

Diese Beispiele fügen einen Ereignislistener für das timeupdate Ereignis des HTMLMediaElement hinzu und senden dann eine Nachricht, wenn dieser Ereignishandler auf das Erscheinen des Ereignisses reagiert hat. Denken Sie daran, dass die Frequenz des Ereignisses von der Systemlast abhängt.

Verwendung von addEventListener():

js
const video = document.querySelector("video");

video.addEventListener("timeupdate", (event) => {
  console.log("The currentTime attribute has been updated. Again.");
});

Verwendung der ontimeupdate Event-Handler-Eigenschaft:

js
const video = document.querySelector("video");

video.ontimeupdate = (event) => {
  console.log("The currentTime attribute has been updated. Again.");
};

Spezifikationen

Specification
HTML
# event-media-timeupdate
HTML
# handler-ontimeupdate

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
timeupdate event

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

Verwandte Ereignisse

Siehe auch