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.

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():

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

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

Verwendung der ontimeupdate Event-Handler-Eigenschaft:

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

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

Spezifikationen

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

Browser-Kompatibilität

BCD tables only load in the browser