CKTIS / JavaScript
Element.setAttribute — establecer un atributo
Element.setAttribute recibe el nombre y el valor de un atributo de un elemento del DOM. Si la llamada tiene éxito, añade el atributo o reemplaza su valor.
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
element.setAttribute(qualifiedName, value)Si la llamada a element.setAttribute(qualifiedName, value) tiene éxito, el método crea el atributo si no existe o actualiza el primer atributo con ese nombre. Es un método del DOM, no una función del propio ECMAScript.
Cuando la política de seguridad de contenido (CSP) exige el uso de Trusted Types, pasar una cadena de texto sin más como valor de un atributo protegido, como onclick, puede provocar un TypeError sin que se cree ni se actualice el atributo.
En los elementos del espacio de nombres HTML que pertenecen a un documento HTML, el nombre se convierte a minúsculas ASCII. Un nombre no válido produce una DOMException de tipo InvalidCharacterError. Usa setAttributeNS para establecer atributos con un espacio de nombres especificado.
Ejemplos
const element = document.createElement('div');
element.setAttribute('data-state', 'draft');
element.setAttribute('data-state', 'ready');
console.log(element.getAttribute('data-state'));Resultado
ready
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. El ejemplo con `data-state` no muestra cómo afecta a un atributo protegido la exigencia de usar Trusted Types.