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.