HTMLMediaElement : évènement canplay

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 canplay est déclenché lorsque l'agent utilisateur peut jouer le média, mais estime que trop peu de données ont été chargées pour le jouer jusqu'à la fin sans avoir à l'arrêter pour charger d'avantage de contenu dans la mémoire tampon (buffer en anglais).

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("canplay", (event) => { })

oncanplay = (event) => { }

Type d'évènement

Un objet Event générique.

Exemples

Ces exemples ajoutent un écouteur d'évènement pour l'évènement canplay 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("canplay", (event) => {
  console.log(
    "La vidéo peut commencer, mais il n'est pas certain qu'elle pourra être lue jusqu'au bout.",
  );
});

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

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

video.oncanplay = (event) => {
  console.log(
    "La vidéo peut commencer, mais il n'est pas certain qu'elle pourra être lue jusqu'au bout.",
  );
};

Spécifications

Spécification
HTML # event-media-canplay
HTML # handler-oncanplay

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 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>

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