HTMLMediaElement : évènement suspend

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 suspend est déclenché lorsque l'agent utilisateur ne récupère pas intentionnellement de données multimédias, auquel cas HTMLMediaElement.networkState est défini sur HTMLMediaElement.NETWORK_IDLE. Cela peut se produire s'il n'y a plus de données à charger ou si le chargement est inutile ; par exemple, le navigateur peut décider de ne mettre en mémoire tampon que 5 minutes d'une vidéo à l'avance, auquel cas le chargement est suspendu jusqu'à ce que l'utilisateur·ice regarde plus de 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("suspend", (event) => { })

onsuspend = (event) => { }

Type d'évènement

Un objet Event générique.

Exemples

Ces exemples ajoutent un écouteur d'évènement pour l'évènement suspend de HTMLMediaElement, puis envoient 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("suspend", (event) => {
  console.log("Le chargement des données a été suspendu.");
});

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

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

video.onsuspend = (event) => {
  console.log("Le chargement des données a été suspendu.");
};

Spécifications

Spécification
HTML # event-media-suspend
HTML # handler-onsuspend

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 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 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>
L'API Web Audio

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