CKTIS / JavaScript
Image — criar um elemento de imagem
Image cria um HTMLImageElement fora da árvore do documento. Os argumentos opcionais definem as dimensões, mas não carregam uma imagem nem alteram o tamanho do ficheiro.
Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxe
new Image(); new Image(width); new Image(width, height)new Image() cria um elemento img do tipo HTMLImageElement, tal como document.createElement("img"). Não o insere no documento. Image é uma API HTML disponibilizada no ambiente Window, não faz parte de ECMAScript; a presença de Node 24 num repositório não comprova a disponibilidade desta API. Os motores de browser atuais suportam este construtor.
Os argumentos opcionais width e height definem os atributos de dimensão correspondentes. Não alteram os dados da imagem; CSS pode influenciar o tamanho final apresentado. naturalWidth e naturalHeight descrevem as dimensões naturais corrigidas pela densidade, em píxeis CSS; valem 0 antes de a imagem estar disponível.
Definir src inicia o processamento assíncrono do recurso, mesmo fora da árvore do documento. Antes de apresentar a imagem, trate os eventos load e error, ou o cumprimento e a rejeição da promise decode(). complete === true, por si só, não comprova o sucesso: também se aplica quando não existe uma origem ou ocorre um erro. Ao apresentar a imagem, defina um alt adequado.
Exemplos
const image = new Image(32, 16);
console.log(image instanceof HTMLImageElement);
console.log(image.width, image.height);
console.log(image.isConnected);
console.log(image.naturalWidth, image.naturalHeight);Resultado
true 32 16 false 0 0
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.