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

CKTIS / HTML

decoding: preferencia de decodificación de imágenes

Distingue la preparación de píxeles de la descarga, carga diferida y presentación.

Versión: HTML Living Standard

Sintaxis

<img decoding="async" src="/picture.svg" alt="Blue square">

El atributo de imagen decoding acepta sync, async o auto. Sugiere coordinar la decodificación con la presentación de otros contenidos o completarla por separado; ausencia y valores inválidos usan el estado automático. Es una sugerencia, no una promesa de fotograma o hilo concreto.

No sustituye carga diferida, prioridad de descarga ni dimensiones. Para esperar explícitamente la decodificación antes de insertar la imagen, utiliza decode() y maneja su rechazo ante fallos de carga o decodificación. Definir el atributo no informa al código de que los píxeles estén listos.

La prueba solicita una imagen local, espera su decodificación correcta y después la añade al documento. Se comprueban dimensiones naturales e inserción real. No se deduce una planificación asíncrona garantizada a partir del valor del atributo.

Ejemplos

<!doctype html><meta charset="utf-8"><div id="mount"></div><output id="result"></output><script>
const image = new Image(); image.alt = 'Blue square'; image.decoding = 'async'; image.src = '/picture.svg';
image.decode().then(() => {
  document.querySelector('#mount').append(image);
  document.querySelector('#result').textContent = 'decoded=' + (image.naturalWidth === 20) + '; mounted=' + image.isConnected;
});
</script>

Resultado

decoded=true; mounted=true

El resultado demuestra decodificación e inserción de esta imagen, no una planificación universal.

Fuentes