CKTIS / JavaScript
HTMLImageElement.src — URL zdroje obrázku
HTMLImageElement.src umožňuje číst nebo nastavit URL obrázku. Vlastnost odráží atribut src. Při čtení vrátí absolutní URL pouze tehdy, pokud lze hodnotu atributu zpracovat jako URL s použitím základní URL dokumentu. Nepotvrzuje, že se obrázek načetl.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
image.src = url;
const resolvedUrl = image.src;HTMLImageElement.src je zapisovatelná textová vlastnost DOM v prohlížeči, nikoli samotného ECMAScriptu. Odráží atribut src prvku img: přiřazení image.src = url tento atribut změní.
Pokud je atribut přítomen, image.src při čtení vrátí absolutní URL pouze tehdy, pokud lze hodnotu atributu zpracovat jako URL s použitím základní URL dokumentu. Pokud se zpracování URL nezdaří, image.src vrátí hodnotu atributu jako USVString. Každá nepárová kódová jednotka UTF-16 z rozsahu surrogátů, uložená v atributu například pomocí setAttribute, se ve vráceném řetězci nahradí náhradním znakem U+FFFD. Například icon.png nelze vyhodnotit vůči neprůhledné základní URL typu data:. Pokud atribut chybí, image.src vrátí prázdný řetězec. Naproti tomu image.getAttribute("src") vrací uloženou hodnotu atributu bez vyhodnocení URL, nebo null, pokud atribut chybí.
Změna src spustí zpracování zdroje obrázku, neznamená však, že se načítání okamžitě dokončí. Zpracovávejte události load a error a obslužné rutiny nastavte před přiřazením hodnoty. Při použití srcset nebo picture se vybraný zdroj může lišit od src; k zobrazení URL aktuálního požadavku použijte currentSrc.
Příklad ověřuje pouze rozlišení URL v samostatném dokumentu s pevně nastavenou základní URL. Neověřuje načítání ani zobrazení obrázku. Spusťte jej v prohlížeči; přítomnost Node 24 v repozitáři nedokazuje podporu tohoto API.
Příklady
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);Výsledek
icon.png https://example.invalid/assets/icon.png
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.