CKTIS / JavaScript
HTMLElement.dataset — dostęp do atrybutów data-*
HTMLElement.dataset udostępnia atrybuty data-* elementu jako DOMStringMap. Pozwala odczytywać, zapisywać i usuwać dane tekstowe, mapując nazwy takie jak data-user-id na userId.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
element.dataset.key
element.dataset.key = value;
element.dataset[key] = value;
delete element.dataset.key;HTMLElement.dataset zwraca powiązany z elementem DOMStringMap, a nie niezależną kopię danych. Zmiany właściwości aktualizują atrybuty data-* i odwrotnie. Samo dataset jest tylko do odczytu; modyfikujesz jego właściwości.
Mapowanie usuwa prefiks data-; łącznik przed małą literą ASCII usuwa się, a literę zamienia na wielką: data-user-id → userId. Pozostałe znaki pozostają bez zmian. Przy zapisie wielkie litery ASCII stają się łącznikiem i małą literą. Zapis klucza zawierającego łącznik przed małą literą ASCII, np. dataset['user-id'], zgłasza SyntaxError.
Wartości są ciągami znaków: liczby konwertuj jawnie. Przypisanie null zapisuje tekst "null", nie usuwa atrybutu. Użyj delete element.dataset.userId, aby go usunąć. Brakujący klucz userId daje undefined.
To interfejs HTML Living Standard, nie funkcja określonej edycji ECMAScript. Obsługują go współczesne silniki przeglądarek; obecność Node 24 w repozytorium nie dowodzi dostępności DOM.
Przykłady
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'));Wynik
42 43 string false
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.