CKTIS / HTML
onloadedmetadata — gestionar la carga de metadatos multimedia
El atributo onloadedmetadata contiene JavaScript que gestiona el evento loadedmetadata, normalmente en audio o video. Indica que los metadatos están disponibles, no que la descarga haya terminado ni que la reproducción vaya a ser ininterrumpida.
Versión: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxis
onloadedmetadata="JavaScript statements"onloadedmetadata es un atributo HTML para gestionar el evento loadedmetadata. Su valor es código JavaScript, no un nombre de evento ni un valor booleano. Está permitido en elementos HTML, aunque se usa normalmente con audio y video.
El navegador activa loadedmetadata cuando los metadatos del recurso que se está cargando están disponibles por primera vez: readyState alcanza al menos HAVE_METADATA. Entonces se pueden leer duration y, en el caso del vídeo, videoWidth y videoHeight. La duración puede ser Infinity si el recurso no tiene un final conocido. Esto no significa que se haya descargado el archivo entero; loadeddata se refiere a la disponibilidad de los datos del fotograma actual.
En el código del atributo, event representa el evento y this, el elemento. En JavaScript, se puede asignar una función a media.onloadedmetadata o usar media.addEventListener('loadedmetadata', handler). El nombre del evento no lleva el prefijo on. Asignar la propiedad reemplaza la función anterior; addEventListener permite tener controladores independientes. Una política CSP puede bloquear el código de los atributos.
El ejemplo activa deliberadamente un evento sintético para probar el atributo sin un archivo multimedia. No carga metadatos ni modifica readyState. Para cargar medios reales, registra el controlador antes de empezar a obtener el recurso.
Ejemplos
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>onloadedmetadata demo</title>
<audio id="media" onloadedmetadata="document.getElementById('result').textContent = event.type + ' handled'"></audio>
<p id="result">Waiting</p>
<script>
const media = document.getElementById('media');
media.dispatchEvent(new Event('loadedmetadata'));
</script>
</html>Resultado
loadedmetadata handled
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.