CKTIS / JavaScript
Element.removeAttribute — eliminar un atributo
Element.removeAttribute elimina un atributo de un elemento por su nombre. Devuelve undefined; si el atributo no existe, no se produce ningún error.
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.removeAttribute(qualifiedName)Element.removeAttribute elimina el primer atributo del elemento cuyo nombre cualificado coincide con el nombre buscado. Es un método del DOM, no una función del propio ECMAScript.
Si el elemento pertenece al espacio de nombres HTML y el documento al que pertenece es un documento HTML, el método convierte las letras mayúsculas ASCII (A–Z) de qualifiedName en minúsculas antes de buscar el atributo. Por ejemplo, removeAttribute('DATA-STATE') puede eliminar el atributo data-state. En los demás casos, el método usa el argumento sin modificar sus mayúsculas ni minúsculas.
La llamada element.removeAttribute(qualifiedName) devuelve undefined, no el valor eliminado. Si no hay ningún atributo que coincida, nada cambia. Los atributos de distintos espacios de nombres pueden tener el mismo nombre cualificado. Una llamada elimina solo el primer atributo que coincide. Si queda algún atributo que coincida, hasAttribute(qualifiedName) devuelve true y getAttribute(qualifiedName) devuelve el valor del primero de los atributos que aún coinciden. Si no queda ninguno, estos métodos devuelven false y null, respectivamente.
Eliminar un atributo no es lo mismo que establecer una cadena vacía con setAttribute: un atributo vacío sigue existiendo. El método no elimina el elemento en sí. Para identificar un atributo por su espacio de nombres y su nombre local, usa removeAttributeNS(namespace, localName).
Ejemplos
const element = document.createElement('div');
element.setAttribute('data-state', 'ready');
console.log(element.getAttribute('data-state'));
const result = element.removeAttribute('data-state');
console.log(element.hasAttribute('data-state'));
console.log(element.getAttribute('data-state'));
console.log(result);
element.removeAttribute('data-state');
console.log(element.hasAttribute('data-state'));Resultado
ready false null undefined false
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.