Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / HTML

decoding: preferência de descodificação de imagem

Distinga a preparação dos píxeis da transferência, carregamento diferido e apresentação.

Versão: HTML Living Standard

Sintaxe

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

O atributo de imagem decoding aceita sync, async ou auto. Sugere coordenar a descodificação com a apresentação de outros conteúdos ou terminá-la separadamente; ausência e valores inválidos usam o estado automático. É uma indicação, não uma promessa sobre um fotograma ou thread concreto.

Não substitui carregamento diferido, prioridade de transferência nem dimensões. Para aguardar explicitamente a descodificação antes de inserir a imagem, use decode() e trate a rejeição em caso de falha de carregamento ou descodificação. Definir o atributo não informa o código de que os píxeis estão prontos.

O teste pede uma imagem local, aguarda a descodificação bem-sucedida e depois adiciona-a ao documento. Verifica dimensões naturais e inserção real. Não deduz um agendamento assíncrono garantido a partir do valor do atributo.

Exemplos

<!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

O resultado demonstra descodificação e inserção desta imagem, não um agendamento universal.

Fontes