WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

HTMLImageElement.src — URL der Bildquelle

Mit HTMLImageElement.src lässt sich eine Bild-URL lesen oder festlegen. Die Eigenschaft bildet das src-Attribut ab. Beim Lesen gibt sie nur dann eine absolute URL zurück, wenn sich der Attributwert mit der Basis-URL des Dokuments als URL parsen lässt. Sie bestätigt nicht, dass das Bild geladen wurde.

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

Syntax

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

HTMLImageElement.src ist eine beschreibbare String-Eigenschaft des Browser-DOM und gehört nicht zu ECMAScript selbst. Sie bildet das src-Attribut eines img-Elements ab: Durch image.src = url wird dieses Attribut geändert.

Ist das Attribut vorhanden, gibt image.src beim Lesen nur dann eine absolute URL zurück, wenn sich der Attributwert mit der Basis-URL des Dokuments als URL parsen lässt. Schlägt das Parsen der URL fehl, gibt image.src den Attributwert als USVString zurück. Jede ungepaarte UTF-16-Surrogatcodeeinheit, die etwa mit setAttribute im Attribut gespeichert wurde, wird in der zurückgegebenen Zeichenfolge durch das Ersatzzeichen U+FFFD ersetzt. Beispielsweise lässt sich icon.png nicht relativ zu einer opaken data:-Basis-URL auflösen. Fehlt das Attribut, gibt image.src eine leere Zeichenfolge zurück. Dagegen liefert image.getAttribute("src") den gespeicherten Attributwert ohne URL-Auflösung oder null, wenn das Attribut fehlt.

Eine Änderung von src startet die Verarbeitung der Bildquelle, bedeutet aber nicht, dass der Ladevorgang sofort abgeschlossen ist. Behandle die Ereignisse load und error und installiere die Handler vor der Zuweisung. Bei srcset oder picture kann sich die ausgewählte Ressource von src unterscheiden; mit currentSrc lässt sich die URL der aktuellen Anfrage prüfen.

Das Beispiel prüft nur die URL-Auflösung in einem separaten Dokument mit festgelegter Basis. Es prüft weder das Abrufen noch die Anzeige des Bildes. Führe es in einem Browser aus; das Vorhandensein von Node 24 in einem Repository belegt nicht, dass diese API unterstützt wird.

Beispiele

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

Ergebnis

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

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen