HTMLMediaElement: ended

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.

L'événement ended est déclenché lorsque la lecture ou le streaming s'est arrêté parce que la fin du média a été atteinte ou qu'aucune donnée n'est disponible.

L'événement se produit dans deux contextes liés mais unique:

  • Les éléments basés sur HTMLMediaElement (<audio> et <video>) déclenchent ended lorsque la lecture du média atteint la fin.

  • Les pistes de flux média, qui sont basées sur l'interface MediaStreamTrack, déclenchent ended lorsque la source de la piste interrompt définitivement l'envoi de données sur le flux. Il y'a différentes manières d'y arriver:

    • il n'y a plus de données à envoyer.
    • L'utilisateur a révoqué les autorisations nécessaires pour que les données soient envoyées.
    • Le matériel générant les données source a été supprimé ou éjecté.
    • Un peer distant a définitivement cessé d'envoyer des données. La mise en pause des médias ne génère pas l'événement ended.

Informations générales

Spécification

HTML5 media et Media Capture and Streams

Interface
Event
Propagation

Non

Annulable

Non

Cible
Element
Action par défaut

Aucune

Note : Bien que cet événement soit défini dans deux spécifications, à ce moment-là, les deux spécifient cet événement de manière identique, nous avons donc documenté comme si elles ne faisaient qu'une. Si à un moment donné, cela change, la documentation sera révisée.

Propriétés

Property Type Description
target Lecture seule EventTarget The event target (the topmost target in the DOM tree).
type Lecture seule DOMString The type of event.
bubbles Lecture seule Boolean Whether the event normally bubbles or not.
cancelable Lecture seule Boolean Whether the event is cancellable or not.

Evénements liés