Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Image — creare un elemento immagine

Image crea un HTMLImageElement al di fuori dell’albero del documento. Gli argomenti opzionali ne impostano le dimensioni, ma non caricano un’immagine né ridimensionano il file.

Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintassi

new Image(); new Image(width); new Image(width, height)

new Image() crea un elemento img di tipo HTMLImageElement, proprio come document.createElement("img"). Non lo inserisce nel documento. Image è un’API HTML esposta nell’ambiente Window, non fa parte di ECMAScript; la presenza di Node 24 in un repository non dimostra che questa API sia disponibile. I motori dei browser attuali supportano questo costruttore.

Gli argomenti opzionali width e height impostano i rispettivi attributi di dimensione. Non modificano i dati dell’immagine; CSS può influire sulle dimensioni finali di visualizzazione. naturalWidth e naturalHeight indicano le dimensioni naturali corrette per la densità, in pixel CSS; valgono 0 prima che l’immagine sia disponibile.

Impostare src avvia l’elaborazione asincrona della risorsa, anche al di fuori dell’albero del documento. Prima di visualizzare l’immagine, gestisci gli eventi load e error, oppure la risoluzione e il rifiuto della promise decode(). complete === true da solo non dimostra il successo: vale anche se manca una sorgente o si è verificato un errore. Quando visualizzi l’immagine, imposta un alt appropriato.

Esempi

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);

Risultato

true
32 16
false
0 0

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti