CKTIS / HTML
onstalled — gestionar descargas de medios bloqueadas
El atributo onstalled especifica el código que se ejecuta ante el evento stalled, cuando el navegador intenta obtener datos multimedia pero estos no llegan. Esto se refiere a la descarga, no necesariamente a una interrupción de la reproducción.
Versión: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxis
HTML: onstalled="JavaScript statements"
JavaScript: media.onstalled = handler;
Alternative: media.addEventListener("stalled", handler);onstalled es un atributo de contenido de controlador de eventos para stalled. Está disponible como atributo HTML global, pero el navegador suele enviar este evento a los elementos multimedia audio y video. Su valor contiene instrucciones JavaScript, no una dirección de recurso ni un valor booleano.
El evento se produce cuando un elemento intenta obtener datos multimedia activamente, pero no recibe ninguno durante el tiempo de espera por bloqueo definido por el mecanismo correspondiente. No significa automáticamente que haya un error o que se interrumpa la reproducción: los datos almacenados en búfer pueden permitir que continúe. waiting se refiere a la reproducción que espera datos, mientras que suspend indica que el navegador ha suspendido la obtención.
En HTML, usa onstalled="..."; en JavaScript, asigna una función a media.onstalled. La asignación reemplaza el controlador anterior de ese espacio. La alternativa media.addEventListener("stalled", handler) registra controladores independientes. No insertes texto no confiable en el código del atributo; la Content Security Policy puede bloquear los controladores inline.
El ejemplo envía un evento sintético para comprobar de forma determinista la conexión del atributo. No descarga ningún archivo ni simula el estado real de la red o del búfer. El texto esperado del párrafo es stalled.
Ejemplos
<!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>Resultado
stalled
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.