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

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.

Fontes