CKTIS / JavaScript
HTMLImageElement.src — URL de la source de l’image
HTMLImageElement.src permet de lire ou de définir l’URL d’une image. Cette propriété reflète l’attribut src. À la lecture, elle ne renvoie une URL absolue que si la valeur de l’attribut peut être interprétée comme une URL à l’aide de l’URL de base du document. Elle ne confirme pas que l’image a été chargée.
Version : 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 est une propriété textuelle modifiable du DOM du navigateur, et non d’ECMAScript lui-même. Elle reflète l’attribut src d’un élément img : l’affectation image.src = url modifie cet attribut.
Si l’attribut est présent, la lecture de image.src ne renvoie une URL absolue que si la valeur de l’attribut peut être interprétée comme une URL à l’aide de l’URL de base du document. Si l’analyse de l’URL échoue, image.src renvoie la valeur de l’attribut sous forme de USVString. Tout demi-codet UTF-16 isolé stocké dans l’attribut, par exemple au moyen de setAttribute, est remplacé par le caractère de remplacement U+FFFD dans la chaîne renvoyée. Par exemple, icon.png ne peut pas être résolu à partir d’une URL de base opaque de type data:. Si l’attribut est absent, image.src renvoie une chaîne vide. En revanche, image.getAttribute("src") renvoie la valeur enregistrée de l’attribut sans résolution d’URL, ou null si l’attribut est absent.
Modifier src déclenche le traitement de la source de l’image, mais ne signifie pas que le chargement se termine immédiatement. Gérez les événements load et error en installant les gestionnaires avant l’affectation. Avec srcset ou picture, la ressource sélectionnée peut différer de src ; utilisez currentSrc pour examiner l’URL de la requête en cours.
L’exemple vérifie uniquement la résolution d’URL dans un document séparé dont la base est fixe. Il ne vérifie ni le téléchargement ni l’affichage de l’image. Exécutez-le dans un navigateur ; la présence de Node 24 dans un dépôt ne prouve pas la prise en charge de cette API.
Exemples
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);Résultat
icon.png https://example.invalid/assets/icon.png
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.