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 Ereignisfrequenz hängt von der Systemlast ab, liegt jedoch zwischen etwa 4Hz und 66Hz (vorausgesetzt, die Event-Handler benötigen nicht länger als 250ms zum Ausführen). Es wird empfohlen, dass Benutzeragenten die Frequenz des Ereignisses basierend auf der Systemlast und den durchschnittlichen Kosten der Verarbeitung des Ereignisses jedes Mal variieren, damit die Benutzeroberfläche nicht häufiger aktualisiert wird, als der Benutzeragent beim Dekodieren des Videos problemlos bewältigen kann.

Dieses Ereignis ist nicht abbruchfähig 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 Event-Listener für das timeupdate-Ereignis von HTMLMediaElement hinzu und senden anschließend eine Nachricht, wenn dieser Event-Handler auf das Auslösen des Ereignisses reagiert hat. Denken Sie daran, die Ereignisfrequenz hängt von der Systemlast ab.

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

Verwandte Ereignisse

Siehe auch