Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / HTML

onsuspend — gérer la suspension du chargement des médias

L’attribut onsuspend indique le code JavaScript à exécuter lors de l’événement suspend. Pour l’audio et la vidéo, cet événement signifie que le navigateur ne récupère volontairement pas de données pour le moment, et non que la lecture a été mise en pause.

Version : WHATWG HTML Living Standard; index snapshot date recorded separately

Syntaxe

onsuspend="JavaScript statements"

onsuspend est un attribut de contenu global de gestionnaire d’événement pour l’événement suspend. Sa valeur est du code JavaScript, et non une adresse de ressource ou une valeur booléenne. Bien que l’attribut soit disponible sur les éléments HTML, il est généralement utilisé avec les éléments audio et video.

Le navigateur déclenche suspend lorsqu’il suspend volontairement la récupération des données multimédias et définit alors networkState sur NETWORK_IDLE. Il peut, par exemple, attendre le début de la lecture avant de télécharger davantage de données. Cela ne signifie pas à lui seul qu’il y a une erreur ou que la lecture est en pause : pause concerne la lecture, tandis que stalled concerne le cas où le navigateur tente de récupérer des données sans en recevoir.

Dans le code de l’attribut, event fournit l’objet événement. En JavaScript, vous pouvez plutôt affecter une fonction à la propriété element.onsuspend ou utiliser element.addEventListener('suspend', handler). Le nom de l’événement ne comporte pas le préfixe on.

L’exemple déclenche un événement synthétique afin que le résultat ne dépende ni du réseau ni des décisions du navigateur concernant la mise en mémoire tampon. Il teste uniquement l’exécution du code de l’attribut ; il ne suspend pas la récupération et ne modifie pas networkState. La politique de sécurité d’une page peut bloquer le code de gestionnaire d’événement écrit directement dans les attributs.

Exemples

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>onsuspend demo</title>
<audio id="media" onsuspend="document.getElementById('result').textContent = event.type"></audio>
<output id="result">pending</output>
<script>
  document.getElementById('media').dispatchEvent(new Event('suspend'));
</script>
</html>

Résultat

suspend

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.

Sources