CKTIS / HTML
onwaiting — gérer l’attente de données multimédias
L’attribut onwaiting définit le code à exécuter lors de l’événement waiting. Sur les éléments audio et video, cet événement indique que la lecture ne peut pas continuer faute de données suffisantes. L’attribut lui-même ne lance ni téléchargement ni lecture.
Version : WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
onwaiting="JavaScript statements"
media.onwaiting = (event) => { /* handle waiting */ };onwaiting est l’attribut de gestion de l’événement waiting. Sa valeur HTML est du code JavaScript, et non une valeur booléenne. Il est disponible sur tous les éléments HTML, mais s’utilise généralement avec les éléments audio et video. Son équivalent JavaScript est la propriété onwaiting.
L’événement waiting indique que la lecture ne peut pas continuer, car les données nécessaires à l’étape suivante ne sont pas disponibles. Il peut survenir au démarrage de la lecture ou lorsque le tampon est épuisé. À lui seul, il ne signifie ni qu’une erreur est permanente ni que la connexion réseau est perdue. Ne le confondez pas avec stalled, qui concerne l’absence d’arrivée de données pendant que le navigateur tente de les récupérer.
Un gestionnaire peut afficher un indicateur d’attente ; l’événement playing permet de réagir au démarrage ou à la reprise de la lecture. Un événement waiting naturel ne remonte pas dans l’arborescence et ne peut pas être annulé : return false ne relancera donc pas la lecture. Affecter une fonction à media.onwaiting remplace le gestionnaire précédent de cette propriété ; addEventListener('waiting', handler) permet d’enregistrer des écouteurs indépendants.
L’exemple déclenche volontairement un événement synthétique afin que son résultat ne dépende ni d’un fichier multimédia ni du réseau. Le paragraphe devrait passer de idle à waiting. Ce test vérifie uniquement le raccordement du gestionnaire : il ne provoque pas de mise en tampon réelle et ne modifie pas l’état de lecture. La politique de sécurité d’une page peut bloquer les scripts intégrés et les gestionnaires d’événements intégrés.
Exemples
<!doctype html>
<meta charset="utf-8">
<title>onwaiting demo</title>
<video id="media" onwaiting="document.getElementById('status').textContent = event.type"></video>
<p id="status">idle</p>
<script>
const media = document.getElementById('media');
media.dispatchEvent(new Event('waiting'));
</script>Résultat
waiting
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.