KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

HTMLImageElement.src — URL van de afbeeldingsbron

Met HTMLImageElement.src kun je een afbeeldings-URL lezen of instellen. De eigenschap weerspiegelt het src-attribuut. Bij het lezen geeft ze alleen een absolute URL terug als de attribuutwaarde met de basis-URL van het document als URL kan worden geparseerd. Dit bevestigt niet dat de afbeelding is geladen.

Versie: 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 is een beschrijfbare stringeigenschap van de browser-DOM, niet van ECMAScript zelf. De eigenschap weerspiegelt het src-attribuut van een img-element: met image.src = url wijzig je dat attribuut.

Als het attribuut aanwezig is, geeft image.src bij het lezen alleen een absolute URL terug als de attribuutwaarde met de basis-URL van het document als URL kan worden geparseerd. Als het parsen van de URL mislukt, geeft image.src de attribuutwaarde terug als USVString. Elke ongepaarde UTF-16-surrogaatcode-eenheid die bijvoorbeeld via setAttribute in het attribuut is opgeslagen, wordt in de teruggegeven tekenreeks vervangen door het vervangingsteken U+FFFD. Zo kan icon.png niet worden opgelost ten opzichte van een opake data:-basis-URL. Als het attribuut ontbreekt, geeft image.src een lege tekenreeks terug. Daarentegen geeft image.getAttribute("src") de opgeslagen attribuutwaarde zonder URL-resolutie terug, of null als het attribuut ontbreekt.

Een wijziging van src start de verwerking van de afbeeldingsbron, maar betekent niet dat het laden meteen klaar is. Verwerk de gebeurtenissen load en error en installeer handlers vóór de toewijzing. Bij srcset of picture kan de geselecteerde bron verschillen van src; gebruik currentSrc om de URL van het huidige verzoek te bekijken.

Het voorbeeld test alleen URL-resolutie in een apart document met een vaste basis. Het test niet of de afbeelding wordt opgehaald of weergegeven. Voer het uit in een browser; de aanwezigheid van Node 24 in een repository bewijst niet dat deze API wordt ondersteund.

Voorbeelden

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

Resultaat

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

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen