HTMLMediaElement : évènement ended

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 ended est déclenché lorsque la lecture ou le flux en direct s'est arrêté parce que la fin du média a été atteinte ou qu'aucune donnée n'est disponible.

Cet évènement se produit lorsque les éléments HTML basés sur HTMLMediaElement (<audio> et <video>) déclenchent ended lorsque la lecture atteint la fin du média.

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

Note : L'évènement ended ne se déclenche pas si la propriété loop vaut true et playbackRate n'est pas négatif.

Syntaxe

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

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

onended = (event) => { }

Type d'évènement

Un objet Event générique.

Exemples

Ces exemples ajoutent un écouteur d'évènement pour l'évènement ended de HTMLMediaElement, puis affichent un message lorsque ce gestionnaire d'évènement a réagi au déclenchement de l'évènement.

Utiliser addEventListener() :

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

video.addEventListener("ended", (event) => {
  console.log(
    "La vidéo s'est arrêtée soit parce qu'elle a terminé sa lecture, soit parce qu'aucune donnée supplémentaire n'est disponible.",
  );
});

Utiliser la propriété de gestionnaire d'évènements onended :

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

video.onended = (event) => {
  console.log(
    "La vidéo s'est arrêtée soit parce qu'elle a terminé sa lecture, soit parce qu'aucune donnée supplémentaire n'est disponible.",
  );
};

Spécifications

Spécification
HTML # event-media-ended
HTML # handler-onended

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 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 timeupdate 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>
Média de capture et flux
- MediaStreamTrack : évènement ended
L'API Web Audio
- L'API Web Audio : évènement ended

Aider à améliorer MDN

Apprendre à contribuer

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

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