CKTIS / JavaScript
HTMLImageElement.src — URL адрес на източника на изображението
HTMLImageElement.src позволява да прочетете или зададете URL адрес на изображение. Свойството отразява атрибута src. При четене то връща абсолютен URL адрес само ако стойността на атрибута може да се интерпретира като URL с помощта на базовия URL адрес на документа. То не потвърждава, че изображението е заредено.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
image.src = url;
const resolvedUrl = image.src;HTMLImageElement.src е записваемо текстово свойство на DOM в браузъра, а не на самия ECMAScript. То отразява атрибута src на елемент img: присвояването image.src = url променя този атрибут.
Ако атрибутът е налице, при четене image.src връща абсолютен URL адрес само ако стойността на атрибута може да се интерпретира като URL с помощта на базовия URL адрес на документа. Ако анализът на URL адреса е неуспешен, image.src връща стойността на атрибута като USVString. Всяка несдвоена сурогатна кодова единица на UTF-16, записана в атрибута например чрез setAttribute, се заменя в върнатия низ със заместващия знак U+FFFD. Например icon.png не може да се разреши спрямо непрозрачен базов URL адрес от вида data:. Когато атрибутът липсва, image.src връща празен низ. За разлика от него, image.getAttribute("src") връща запазената стойност на атрибута без разрешаване на URL или null, ако атрибутът липсва.
Промяната на src задейства обработката на източника на изображението, но не означава, че зареждането приключва веднага. Обработвайте събитията load и error, като инсталирате обработчиците преди присвояването. При srcset или picture избраният ресурс може да се различава от src; използвайте currentSrc, за да проверите URL адреса на текущата заявка.
Примерът проверява само разрешаването на URL в отделен документ с фиксирана база. Той не проверява извличането или показването на изображението. Изпълнете го в браузър; наличието на Node 24 в хранилище не доказва поддръжка на този API.
Примери
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);Резултат
icon.png https://example.invalid/assets/icon.png
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.