CKTIS / HTML
onsuspend — gestionar la suspensión de la carga de medios
El atributo onsuspend especifica el código JavaScript que se ejecuta cuando se produce el evento suspend. En audio y vídeo, este evento significa que el navegador ha dejado de obtener datos deliberadamente por el momento, no que se haya pausado la reproducción.
Versión: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxis
onsuspend="JavaScript statements"onsuspend es un atributo global de contenido para gestionar el evento suspend. Su valor es código JavaScript, no una dirección de recurso ni un valor booleano. Aunque el atributo está disponible en los elementos HTML, su uso habitual es con los elementos audio y video.
El navegador dispara suspend cuando suspende deliberadamente la obtención de datos multimedia y establece networkState en NETWORK_IDLE. Por ejemplo, puede esperar a que comience la reproducción antes de descargar más datos. Esto no significa por sí solo que haya un error ni que la reproducción esté en pausa: pause se refiere a la reproducción, mientras que stalled se refiere a que el navegador intenta obtener datos pero no los recibe.
Dentro del código del atributo, event proporciona el objeto del evento. En JavaScript, puedes asignar una función a la propiedad element.onsuspend o usar element.addEventListener('suspend', handler). El nombre del evento no incluye el prefijo on.
El ejemplo dispara un evento sintético para que el resultado no dependa de la red ni de las decisiones del navegador sobre el almacenamiento en búfer. Solo comprueba que se ejecuta el código del atributo; no suspende la obtención de datos ni cambia networkState. La política de seguridad de una página puede bloquear el código de gestión de eventos escrito directamente en atributos.
Ejemplos
<!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>Resultado
suspend
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.