Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

HTMLImageElement.src — adres źródła obrazu

HTMLImageElement.src pozwala odczytać lub ustawić adres obrazu. Właściwość odzwierciedla atrybut src. Przy odczycie zwraca adres bezwzględny tylko wtedy, gdy wartość atrybutu można zinterpretować jako URL przy użyciu adresu bazowego dokumentu. Nie potwierdza załadowania obrazu.

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

Składnia

image.src = url;
const resolvedUrl = image.src;

HTMLImageElement.src to zapisywalna właściwość tekstowa przeglądarkowego interfejsu DOM, a nie samego ECMAScript. Odzwierciedla atrybut src elementu img: przypisanie image.src = url zmienia ten atrybut.

Jeśli atrybut istnieje, odczyt image.src zwraca adres bezwzględny tylko wtedy, gdy wartość atrybutu można zinterpretować jako URL przy użyciu adresu bazowego dokumentu. Jeśli analiza URL się nie powiedzie, image.src zwraca wartość atrybutu jako USVString. Oznacza to, że każda niesparowana jednostka kodowa UTF-16 z zakresu surogatów, zapisana w atrybucie na przykład przez setAttribute, zostaje w zwracanym ciągu zastąpiona znakiem zastępczym U+FFFD. Na przykład icon.png nie można rozwiązać względem nieprzezroczystego adresu bazowego data:. Jeśli atrybutu nie ma, image.src zwraca pusty ciąg. Natomiast image.getAttribute("src") zwraca zapisaną wartość atrybutu bez rozwiązywania adresu albo null, gdy atrybut nie istnieje.

Zmiana src uruchamia przetwarzanie źródła obrazu, lecz nie oznacza natychmiastowego zakończenia ładowania. Obsługuj zdarzenia load i error, instalując procedury obsługi przed przypisaniem. Przy użyciu srcset lub picture wybrany zasób może różnić się od src; do sprawdzenia adresu bieżącego żądania służy currentSrc.

Przykład sprawdza wyłącznie rozwiązywanie adresu w osobnym dokumencie o ustalonej bazie. Nie sprawdza pobierania ani wyświetlania obrazu. Uruchom go w przeglądarce; obecność Node 24 w repozytorium nie dowodzi dostępności tego API.

Przykłady

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

Wynik

icon.png
https://example.invalid/assets/icon.png

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła