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

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.

Fuentes