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

CKTIS / HTML

onloadeddata — gestionar los datos multimedia disponibles

El atributo onloadeddata ejecuta código cuando se produce el evento loadeddata, al estar disponibles por primera vez los datos de la posición de reproducción actual de audio o vídeo. No significa que se haya descargado el archivo completo ni que haya empezado la reproducción.

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

Sintaxis

<video onloadeddata="handleData(event)"></video>
<audio onloadeddata="handleData(event)"></audio>
media.onloadeddata = handleData;

onloadeddata es un atributo HTML de gestión del evento loadeddata. Está disponible en elementos HTML, pero se usa principalmente con audio y video. Su valor es código JavaScript, no un valor booleano.

El navegador activa loadeddata cuando, durante la carga, puede representar por primera vez datos de la posición de reproducción actual: readyState alcanza HAVE_CURRENT_DATA (2) o un estado superior. En vídeo, esto significa que el fotograma actual está disponible, no la película completa. loadedmetadata se refiere a los metadatos, mientras que canplay indica que la reproducción puede avanzar al menos un poco. loadeddata no inicia la reproducción por sí mismo.

En JavaScript, asigna una función a media.onloadeddata; una asignación posterior reemplaza el gestor anterior de ese espacio. Como alternativa, usa media.addEventListener('loadeddata', handler). El nombre del evento no lleva el prefijo on. La política de seguridad de contenido (Content Security Policy) puede bloquear los gestores escritos directamente en atributos.

El ejemplo activa deliberadamente un evento sintético. Comprueba la conexión entre el atributo y el gestor, y la actualización del texto, pero no comprueba la decodificación ni la disponibilidad del contenido multimedia.

Ejemplos

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>onloadeddata demo</title>
<audio id="media" onloadeddata="document.getElementById('result').textContent = event.type"></audio>
<p id="result">waiting</p>
<script>
  // Synthetic event: tests the handler, not media loading.
  document.getElementById('media').dispatchEvent(new Event('loadeddata'));
</script>
</html>

Resultado

loadeddata

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