CKTIS / JavaScript
HTMLImageElement.src — URL della sorgente dell’immagine
HTMLImageElement.src permette di leggere o impostare l’URL di un’immagine. La proprietà riflette l’attributo src. In lettura restituisce un URL assoluto solo se il valore dell’attributo può essere interpretato come URL usando l’URL di base del documento. Non conferma che l’immagine sia stata caricata.
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
image.src = url;
const resolvedUrl = image.src;HTMLImageElement.src è una proprietà testuale scrivibile del DOM del browser, non di ECMAScript in sé. Riflette l’attributo src di un elemento img: assegnare image.src = url modifica quell’attributo.
Se l’attributo è presente, la lettura di image.src restituisce un URL assoluto solo se il valore dell’attributo può essere interpretato come URL usando l’URL di base del documento. Se l’analisi dell’URL non riesce, image.src restituisce il valore dell’attributo come USVString. Ogni unità di codice surrogata UTF-16 non accoppiata, memorizzata nell’attributo per esempio tramite setAttribute, viene sostituita dal carattere sostitutivo U+FFFD nella stringa restituita. Ad esempio, icon.png non può essere risolto rispetto a un URL di base opaco di tipo data:. Se l’attributo manca, image.src restituisce una stringa vuota. Al contrario, image.getAttribute("src") restituisce il valore memorizzato dell’attributo senza risolvere l’URL, oppure null se l’attributo è assente.
Modificare src avvia l’elaborazione della sorgente dell’immagine, ma non significa che il caricamento termini subito. Gestisci gli eventi load ed error installando i gestori prima dell’assegnazione. Con srcset o picture, la risorsa selezionata può essere diversa da src; usa currentSrc per controllare l’URL della richiesta corrente.
L’esempio verifica soltanto la risoluzione dell’URL in un documento separato con una base fissa. Non verifica il recupero né la visualizzazione dell’immagine. Eseguilo in un browser; la presenza di Node 24 in un repository non dimostra il supporto di questa API.
Esempi
const doc = document.implementation.createHTMLDocument("Demo");
const base = doc.createElement("base");
base.href = "https://example.invalid/assets/";
doc.head.append(base);
const image = doc.createElement("img");
image.src = "icon.png";
console.log(image.getAttribute("src"));
console.log(image.src);Risultato
icon.png https://example.invalid/assets/icon.png
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.