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.