CKTIS / JavaScript
HTMLElement.dataset — accesso agli attributi data-*
HTMLElement.dataset espone gli attributi data-* di un elemento come DOMStringMap. Consente di leggere, scrivere ed eliminare dati testuali, associando per esempio data-user-id a userId.
Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintassi
element.dataset.key
element.dataset.key = value;
element.dataset[key] = value;
delete element.dataset.key;HTMLElement.dataset restituisce un DOMStringMap associato all’elemento, non una copia indipendente dei dati. Le modifiche alle proprietà aggiornano gli attributi data-* e viceversa. La proprietà dataset stessa è di sola lettura; si modificano le sue proprietà.
La conversione dei nomi rimuove il prefisso data-; un trattino prima di una lettera ASCII minuscola viene eliminato e quella lettera diventa maiuscola: data-user-id → userId. Gli altri caratteri restano invariati. In scrittura, le lettere ASCII maiuscole diventano un trattino seguito dalla lettera minuscola. Scrivere una chiave che contiene un trattino prima di una lettera ASCII minuscola, come dataset['user-id'], genera SyntaxError.
I valori sono stringhe: converti esplicitamente i numeri. Assegnando null si memorizza il testo "null", invece di rimuovere l’attributo. Per rimuoverlo, usa delete element.dataset.userId. Se manca la chiave userId, il risultato è undefined.
Questa è un’interfaccia dell’HTML Living Standard, non una funzionalità di una specifica edizione di ECMAScript. I motori dei browser attuali la supportano; la presenza di Node 24 in un repository non dimostra che il DOM sia disponibile.
Esempi
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'));Risultato
42 43 string false
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.