Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

HTMLImageElement.src — URL de origen de la imagen

HTMLImageElement.src permite leer o establecer la URL de una imagen. Esta propiedad refleja el atributo src. Al leerla, solo devuelve una URL absoluta si el valor del atributo se puede interpretar como URL usando la URL base del documento. No confirma que la imagen se haya cargado.

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

Sintaxis

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

HTMLImageElement.src es una propiedad de texto modificable del DOM del navegador, no de ECMAScript en sí. Refleja el atributo src de un elemento img: asignar image.src = url cambia ese atributo.

Si el atributo existe, al leer image.src solo se obtiene una URL absoluta si el valor del atributo se puede interpretar como URL usando la URL base del documento. Si el análisis de la URL falla, image.src devuelve el valor del atributo como USVString. Toda unidad de código sustituta de UTF-16 sin pareja almacenada en el atributo, por ejemplo mediante setAttribute, se reemplaza por el carácter de reemplazo U+FFFD en la cadena devuelta. Por ejemplo, icon.png no se puede resolver con una URL base opaca de tipo data:. Si falta el atributo, image.src devuelve una cadena vacía. En cambio, image.getAttribute("src") devuelve el valor almacenado del atributo sin resolver la URL, o null si el atributo no existe.

Cambiar src inicia el procesamiento del origen de la imagen, pero no significa que la carga termine de inmediato. Gestiona los eventos load y error e instala los controladores antes de asignar el valor. Con srcset o picture, el recurso seleccionado puede ser distinto de src; usa currentSrc para consultar la URL de la solicitud actual.

El ejemplo comprueba únicamente la resolución de URL en un documento separado con una base fija. No comprueba la descarga ni la visualización de la imagen. Ejecútalo en un navegador; que Node 24 esté presente en un repositorio no demuestra que esta API sea compatible.

Ejemplos

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

Resultado

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

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes