CKTIS / JavaScript
HTMLElement.dataset — достъп до атрибутите data-*
HTMLElement.dataset предоставя атрибутите data-* на даден елемент като DOMStringMap. С него можете да четете, записвате и изтривате текстови данни; например data-user-id се преобразува в userId.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
element.dataset.key
element.dataset.key = value;
element.dataset[key] = value;
delete element.dataset.key;HTMLElement.dataset връща свързана с елемента DOMStringMap, а не независимо копие на данните. Промените в свойствата актуализират атрибутите data-* и обратно. Самото свойство dataset е само за четене; променят се неговите свойства.
При преобразуването на имената префиксът data- се премахва; тире пред малка ASCII буква се премахва и буквата става главна: data-user-id → userId. Останалите знаци не се променят. При записване главните ASCII букви се преобразуват в тире, последвано от малка буква. Записването на ключ, съдържащ тире пред малка ASCII буква, например dataset['user-id'], хвърля SyntaxError.
Стойностите са низове: преобразувайте числата изрично. Присвояването на null записва текста "null", вместо да премахне атрибута. Използвайте delete element.dataset.userId, за да го премахнете. Липсващият ключ userId връща undefined.
Това е интерфейс от HTML Living Standard, а не функция на конкретно издание на ECMAScript. Съвременните браузърни енджини го поддържат; наличието на Node 24 в хранилище не доказва, че DOM е наличен.
Примери
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'));Резултат
42 43 string false
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.