Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / HTML

onprogress — gestionar eventos de progreso de descarga

El atributo onprogress contiene JavaScript que gestiona el evento progress. En los elementos audio y video, se refiere a la descarga de datos multimedia, no al tiempo de reproducción transcurrido.

Versión: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxis

onprogress="JavaScript statements"
element.onprogress = handler;
element.addEventListener("progress", handler);

onprogress es un atributo de gestión del evento progress. Está disponible en todos los elementos HTML, pero su mera presencia no inicia descargas ni genera eventos. La propiedad JavaScript correspondiente también está disponible en los objetos Document y Window.

En audio y video, progress informa de la descarga de datos multimedia. No indica el progreso de la reproducción ni proporciona automáticamente un porcentaje de bytes descargados. El evento multimedia usa la interfaz Event, no ProgressEvent; no des por hecho que loaded y total están disponibles.

El valor del atributo es código JavaScript, donde event hace referencia al evento. También puedes asignar una función a element.onprogress o usar element.addEventListener("progress", handler). Asignar la propiedad reemplaza el controlador anterior de ese mecanismo; addEventListener() permite registrar escuchas independientes.

El ejemplo envía explícitamente un evento progress sintético, por lo que el resultado no depende de la red. Comprueba la gestión del atributo, no el progreso real de una descarga. La Content Security Policy puede bloquear los controladores de eventos y los scripts en línea.

Ejemplos

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>onprogress demo</title>
<body>
<audio id="media" onprogress="document.getElementById('result').textContent = event.type"></audio>
<p id="result">waiting</p>
<script>
  document.getElementById('media').dispatchEvent(new Event('progress'));
</script>
</body>
</html>

Resultado

progress

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.

Fuentes