CKTIS / JavaScript
Element.getAttribute — einen Attributwert auslesen
Element.getAttribute liest das Attribut eines DOM-Elements als Zeichenfolge aus oder gibt null zurück, wenn das Attribut nicht existiert.
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.getAttribute(qualifiedName)element.getAttribute(qualifiedName) gibt den Wert des ersten Attributs mit dem angegebenen qualifizierten Namen zurück. Das Ergebnis ist eine Zeichenfolge oder null, wenn das Attribut nicht existiert. Ein leerer Wert ist "", nicht null; der Text "12" ist keine Zahl. Die Methode verändert das Element nicht.
Bei Elementen im HTML-Namespace, die zu einem HTML-Dokument gehören, wird der Name vor der Suche in ASCII-Kleinbuchstaben umgewandelt. Außerhalb dieses Falls ist die Groß- und Kleinschreibung relevant. Verwende getAttributeNS(namespace, localName), um ein Attribut anhand von Namespace und lokalem Namen zu suchen.
Beispiele
const element = document.createElement('div');
element.setAttribute('data-count', '12');
element.setAttribute('data-empty', '');
console.log(JSON.stringify([
element.getAttribute('data-count'),
element.getAttribute('data-empty'),
element.getAttribute('data-missing')
]));Ergebnis
["12","",null]
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.