WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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.

Quellen