CKTIS / HTML
oncanplaythrough — gérer la disponibilité estimée du média
L’attribut oncanplaythrough contient du JavaScript qui gère l’événement canplaythrough. Pour l’audio et la vidéo, cet événement indique que la lecture pourrait, selon une estimation, aller jusqu’au bout sans mise en mémoire tampon supplémentaire ; il ne garantit pas une lecture ininterrompue.
Version : WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
<audio oncanplaythrough="/* JavaScript */"></audio>
<video oncanplaythrough="/* JavaScript */"></video>oncanplaythrough est un attribut de gestion d’événement pour canplaythrough. Sa valeur est du code JavaScript, et non une valeur booléenne. Il est généralement utilisé avec les éléments audio et video ; le code du gestionnaire peut accéder à l’objet event.
Le navigateur met canplaythrough en file d’attente lorsque readyState passe à HAVE_ENOUGH_DATA (4). Cela signifie généralement qu’il estime que la lecture, au playbackRate actuel, peut atteindre la fin sans mise en mémoire tampon supplémentaire. Cet état couvre aussi les situations où attendre davantage ne permettrait pas d’obtenir plus de données. Il ne garantit ni ne confirme le téléchargement du fichier entier. canplay indique un niveau de disponibilité inférieur : la possibilité de démarrer ou de reprendre la lecture.
Ne confondez pas le nom de l’attribut oncanplaythrough avec le nom de l’événement canplaythrough. On peut aussi affecter une fonction à la propriété element.oncanplaythrough ou utiliser element.addEventListener('canplaythrough', handler). L’attribut contient du code, tandis que la propriété reçoit une fonction.
L’exemple déclenche volontairement un événement synthétique : sa vérification ne nécessite donc ni fichier multimédia ni connexion réseau. Le texte attendu dans le paragraphe est canplaythrough ; ce test vérifie uniquement le branchement du gestionnaire, et non la disponibilité réelle du média.
Exemples
<!doctype html>
<meta charset="utf-8">
<title>oncanplaythrough test</title>
<audio id="media" oncanplaythrough="document.getElementById('status').textContent = event.type"></audio>
<p id="status">Pending</p>
<script>
const media = document.getElementById('media');
media.dispatchEvent(new Event('canplaythrough'));
</script>Résultat
canplaythrough
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.