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

CKTIS / JavaScript

HTMLImageElement.alt — texto alternativo de la imagen

HTMLImageElement.alt lee y establece el texto que sustituye a una imagen. La propiedad refleja el atributo alt; una cadena vacía y la ausencia del atributo no significan lo mismo.

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.alt
image.alt = "Replacement text";

HTMLImageElement.alt es una propiedad DOMString que se puede escribir y que refleja el atributo alt de un elemento img. Al leerla, devuelve su valor; al asignarle uno, se actualiza el atributo. Si el atributo no existe, la lectura devuelve "".

El texto debe sustituir el significado de la imagen en su contexto, no limitarse a describir su aspecto. Para una imagen decorativa o que repite información cercana, usa image.alt = "". La ausencia del atributo no equivale a un valor vacío. alt no es una ayuda emergente como title.

El ejemplo distingue entre la ausencia del atributo y un valor vacío mediante hasAttribute("alt"), y muestra el cambio que puede observarse con getAttribute("alt"). Ejecútalo en un navegador: es una interfaz del DOM HTML, no una característica del lenguaje ECMAScript. Que Node 24 esté en el repositorio no demuestra que esta interfaz esté disponible.

Ejemplos

const image = document.createElement("img");
console.log(JSON.stringify([image.alt, image.hasAttribute("alt")]));

image.alt = "Orange cat sleeping";
console.log(image.getAttribute("alt"));

image.alt = "";
console.log(JSON.stringify([image.alt, image.hasAttribute("alt")]));

Resultado

["",false]
Orange cat sleeping
["",true]

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