CKTIS / JavaScript
Element.removeAttribute — remover um atributo
Element.removeAttribute remove um atributo de um elemento pelo nome. Devolve undefined; a ausência do atributo não provoca um erro.
Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxe
element.removeAttribute(qualifiedName)Element.removeAttribute remove o primeiro atributo do elemento cujo nome qualificado corresponde ao nome procurado. É um método do DOM, não uma função do próprio ECMAScript.
Se o elemento pertencer ao espaço de nomes HTML e o documento a que pertence for um documento HTML, o método converte as letras maiúsculas ASCII (A–Z) de qualifiedName em minúsculas antes de procurar o atributo. Por exemplo, removeAttribute('DATA-STATE') pode remover o atributo data-state. Nos restantes casos, o método utiliza o argumento sem alterar as maiúsculas ou as minúsculas.
A chamada element.removeAttribute(qualifiedName) devolve undefined, não o valor removido. Se não houver nenhum atributo que corresponda ao nome, nada muda. Atributos de espaços de nomes diferentes podem ter o mesmo nome qualificado. Uma chamada remove apenas o primeiro atributo que corresponde ao nome. Se restar algum atributo com esse nome, hasAttribute(qualifiedName) devolve true e getAttribute(qualifiedName) devolve o valor do primeiro dos atributos que ainda correspondem ao nome. Se não restar nenhum, estes métodos devolvem, respetivamente, false e null.
Remover um atributo é diferente de definir uma cadeia vazia com setAttribute: um atributo vazio continua a existir. O método não remove o próprio elemento. Para identificar um atributo pelo espaço de nomes e pelo nome local, utiliza removeAttributeNS(namespace, localName).
Exemplos
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
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.