CKTIS / HTML
onwaiting: gestionar la espera de datos multimedia
El atributo onwaiting especifica el código que se ejecuta ante el evento waiting. En los elementos audio y video, este evento indica que la reproducción no puede continuar porque no hay suficientes datos disponibles. El atributo por sí solo no inicia la descarga ni la reproducción.
Versión: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxis
onwaiting="JavaScript statements"
media.onwaiting = (event) => { /* handle waiting */ };onwaiting es el atributo de gestión del evento waiting. Su valor HTML es código JavaScript, no un valor booleano. Está disponible en todos los elementos HTML, aunque suele usarse con los elementos audio y video. Su equivalente en JavaScript es la propiedad onwaiting.
El evento waiting indica que la reproducción no puede continuar porque no están disponibles los datos necesarios para el siguiente paso. Puede producirse al iniciar la reproducción o cuando se agota el búfer. Por sí solo, no significa que haya un error permanente ni que se haya perdido la conexión de red. No lo confundas con stalled, que se refiere a que no llegan datos mientras el navegador intenta obtenerlos.
Un controlador puede mostrar un indicador de espera; el evento playing permite responder cuando la reproducción comienza o se reanuda. Un evento waiting natural no se propaga y no se puede cancelar, así que return false no reanudará la reproducción. Asignar una función a media.onwaiting sustituye el controlador anterior de esa propiedad; addEventListener('waiting', handler) permite registrar oyentes independientes.
El ejemplo envía deliberadamente un evento sintético para que el resultado no dependa de un archivo multimedia ni de la red. El párrafo debería cambiar de idle a waiting. Esto solo comprueba que el controlador esté conectado: no provoca un almacenamiento en búfer real ni cambia el estado de reproducción. La política de seguridad de una página puede bloquear los scripts y controladores de eventos en línea.
Ejemplos
<!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>Resultado
waiting
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.