Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes