CKTIS / JavaScript
HTMLElement.dataset — Zugriff auf data-*-Attribute
HTMLElement.dataset stellt die data-*-Attribute eines Elements als DOMStringMap bereit. Damit lassen sich Textdaten lesen, schreiben und löschen; Namen wie data-user-id werden auf userId abgebildet.
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.dataset.key
element.dataset.key = value;
element.dataset[key] = value;
delete element.dataset.key;HTMLElement.dataset gibt eine einem Element zugeordnete DOMStringMap zurück, keine unabhängige Datenkopie. Änderungen an Eigenschaften aktualisieren die data-*-Attribute und umgekehrt. Die Eigenschaft dataset selbst ist schreibgeschützt; geändert werden ihre Eigenschaften.
Bei der Namenszuordnung wird das Präfix data- entfernt. Ein Bindestrich vor einem kleingeschriebenen ASCII-Buchstaben entfällt, und dieser Buchstabe wird großgeschrieben: data-user-id → userId. Andere Zeichen bleiben unverändert. Beim Schreiben werden ASCII-Großbuchstaben in einen Bindestrich mit anschließendem Kleinbuchstaben umgewandelt. Das Schreiben eines Schlüssels mit einem Bindestrich vor einem kleingeschriebenen ASCII-Buchstaben, etwa dataset['user-id'], löst SyntaxError aus.
Werte sind Zeichenfolgen: Zahlen müssen ausdrücklich konvertiert werden. Die Zuweisung von null speichert den Text "null", statt das Attribut zu entfernen. Mit delete element.dataset.userId wird es entfernt. Für einen fehlenden Schlüssel userId wird undefined zurückgegeben.
Dies ist eine Schnittstelle des HTML Living Standard und keine Funktion einer bestimmten ECMAScript-Ausgabe. Aktuelle Browser-Engines unterstützen sie; dass ein Repository Node 24 enthält, belegt nicht, dass ein DOM verfügbar ist.
Beispiele
const element = document.createElement('div');
element.setAttribute('data-user-id', '42');
console.log(element.dataset.userId);
element.dataset.userId = Number(element.dataset.userId) + 1;
console.log(element.getAttribute('data-user-id'));
console.log(typeof element.dataset.userId);
delete element.dataset.userId;
console.log(element.hasAttribute('data-user-id'));Ergebnis
42 43 string 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.