HTMLMediaElement : évènement timeupdate

Baseline Large disponibilité

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2015.

L'évènement timeupdate est déclenché lorsque le temps indiqué par l'attribut currentTime a été mis à jour.

La fréquence de l'évènement dépend de la charge du système, mais il sera déclenché entre environ 4Hz et 66Hz (en supposant que les gestionnaires d'évènements ne prennent pas plus de 250ms pour s'exécuter). Les agents utilisateurs sont encouragés à varier la fréquence de l'évènement en fonction de la charge du système et du coût moyen de traitement de l'évènement à chaque fois, afin que les mises à jour de l'interface utilisateur ne soient pas plus fréquentes que ce que l'agent utilisateur peut gérer confortablement tout en décodant la vidéo.

Cet évènement n'est pas annulable et ne se propage pas.

Syntaxe

Utilisez le nom de l'évènement dans des méthodes comme addEventListener(), ou définissez une propriété de gestionnaire d'évènement.

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

ontimeupdate = (event) => { }

Type d'évènement

Un objet Event générique.

Exemples

Ces exemples ajoutent un écouteur d'évènement pour l'évènement timeupdate de HTMLMediaElement, puis affichent un message lorsque ce gestionnaire d'évènement a réagi au déclenchement de l'évènement. N'oubliez pas que la fréquence de l'évènement dépend de la charge du système.

Utiliser addEventListener() :

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

video.addEventListener("timeupdate", (event) => {
  console.log("L'attribut currentTime a été mis à jour. Encore.");
});

Utiliser la propriété de gestionnaire d'évènement ontimeupdate :

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

video.ontimeupdate = (event) => {
  console.log("L'attribut currentTime a été mis à jour. Encore.");
};

Spécifications

Spécification
HTML # event-media-timeupdate
HTML # handler-ontimeupdate

Compatibilité des navigateurs

Évènements associés

L'évènement playing de HTMLMediaElement
L'évènement waiting de HTMLMediaElement
L'évènement seeking de HTMLMediaElement
L'évènement seeked de HTMLMediaElement
L'évènement ended de HTMLMediaElement
L'évènement loadedmetadata de HTMLMediaElement
L'évènement loadeddata de HTMLMediaElement
L'évènement canplay de HTMLMediaElement
L'évènement canplaythrough de HTMLMediaElement
L'évènement durationchange de HTMLMediaElement
L'évènement play de HTMLMediaElement
L'évènement pause de HTMLMediaElement
L'évènement ratechange de HTMLMediaElement
L'évènement volumechange de HTMLMediaElement
L'évènement suspend de HTMLMediaElement
L'évènement emptied de HTMLMediaElement
L'évènement stalled de HTMLMediaElement

Voir aussi

L'interface HTMLAudioElement
L'interface HTMLVideoElement
L'élément HTML <audio>
L'élément HTML <video>

Aider à améliorer MDN

Apprendre à contribuer

Cette page a été modifiée le 20 avr. 2026 par les contributeur·ice·s du MDN.

Voir cette page sur GitHub • Signaler un problème avec ce contenu