WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Element.removeAttribute — ein Attribut entfernen

Element.removeAttribute entfernt ein Attribut eines Elements anhand seines Namens. Die Methode gibt undefined zurück; ein fehlendes Attribut verursacht keinen Fehler.

Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

element.removeAttribute(qualifiedName)

Element.removeAttribute entfernt das erste Attribut des Elements mit passendem qualifiziertem Namen. Es handelt sich um eine DOM-Methode und nicht um eine Funktion von ECMAScript selbst.

Gehört das Element zum HTML-Namensraum und ist das Dokument, zu dem es gehört, ein HTML-Dokument, wandelt die Methode vor der Suche nach dem Attribut die ASCII-Großbuchstaben (A–Z) in qualifiedName in Kleinbuchstaben um. So kann removeAttribute('DATA-STATE') beispielsweise das Attribut data-state entfernen. Andernfalls verwendet die Methode das Argument, ohne die Groß- und Kleinschreibung zu ändern.

Der Aufruf element.removeAttribute(qualifiedName) gibt undefined zurück, nicht den entfernten Wert. Gibt es kein passendes Attribut, ändert sich nichts. Attribute in unterschiedlichen Namensräumen können denselben qualifizierten Namen haben. Ein einzelner Aufruf entfernt nur das erste passende Attribut. Bleibt ein weiteres passendes Attribut übrig, gibt hasAttribute(qualifiedName) true zurück und getAttribute(qualifiedName) liefert den Wert des ersten verbliebenen passenden Attributs. Bleibt kein passendes Attribut übrig, geben die Methoden false beziehungsweise null zurück.

Ein Attribut zu entfernen ist nicht dasselbe, wie mit setAttribute eine leere Zeichenfolge festzulegen: Ein leeres Attribut ist weiterhin vorhanden. Die Methode entfernt nicht das Element selbst. Um ein Attribut anhand seines Namensraums und lokalen Namens anzugeben, verwende removeAttributeNS(namespace, localName).

Beispiele

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'));

Ergebnis

ready
false
null
undefined
false

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen