CKTIS / HTML
onstalled — gérer les téléchargements multimédias bloqués
L’attribut onstalled définit le code à exécuter lors de l’événement stalled, lorsque le navigateur tente de récupérer des données multimédias mais que celles-ci n’arrivent pas. Cela concerne le téléchargement, pas nécessairement une interruption de la lecture.
Version : WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
HTML: onstalled="JavaScript statements"
JavaScript: media.onstalled = handler;
Alternative: media.addEventListener("stalled", handler);onstalled est un attribut de contenu gestionnaire d’événement pour stalled. Il est disponible comme attribut HTML global, mais le navigateur déclenche naturellement cet événement sur les éléments multimédias audio et video. Sa valeur contient des instructions JavaScript, et non une adresse de ressource ou une valeur booléenne.
L’événement se produit lorsqu’un élément essaie activement d’obtenir des données multimédias, mais n’en reçoit pas pendant le délai d’attente prévu par le mécanisme de détection de blocage. Cela ne signifie pas automatiquement qu’il y a une erreur ou que la lecture est interrompue : les données mises en mémoire tampon peuvent permettre à la lecture de continuer. waiting concerne la lecture en attente de données, tandis que suspend indique que le navigateur a suspendu la récupération.
En HTML, utilisez onstalled="..." ; en JavaScript, attribuez une fonction à media.onstalled. Cette affectation remplace le gestionnaire précédent dans le même emplacement. L’alternative media.addEventListener("stalled", handler) enregistre des écouteurs indépendants. N’insérez pas de texte non fiable dans le code d’un attribut ; la Content Security Policy peut bloquer les gestionnaires inline.
L’exemple déclenche un événement synthétique afin de vérifier de manière déterministe le câblage de l’attribut. Il ne télécharge aucun fichier et ne simule pas l’état réel du réseau ni du tampon. Le texte attendu dans le paragraphe est stalled.
Exemples
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>onstalled demonstration</title>
<audio id="media" onstalled="document.getElementById('status').textContent = event.type"></audio>
<p id="status">pending</p>
<script>
const media = document.getElementById('media');
media.dispatchEvent(new Event('stalled'));
</script>
</html>Résultat
stalled
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.