CKTIS / JavaScript
HTMLElement.dataset — acceso a los atributos data-*
HTMLElement.dataset expone los atributos data-* de un elemento como un DOMStringMap. Permite leer, escribir y eliminar datos de texto; por ejemplo, asigna data-user-id a userId.
Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxis
element.dataset.key
element.dataset.key = value;
element.dataset[key] = value;
delete element.dataset.key;HTMLElement.dataset devuelve un DOMStringMap asociado al elemento, no una copia independiente de los datos. Los cambios en sus propiedades actualizan los atributos data-*, y viceversa. La propiedad dataset en sí es de solo lectura; lo que se modifica son sus propiedades.
El mapeo de nombres elimina el prefijo data-; se elimina un guion antes de una letra ASCII minúscula y esa letra pasa a mayúscula: data-user-id → userId. Los demás caracteres no cambian. Al escribir, las letras ASCII mayúsculas se convierten en un guion seguido de una minúscula. Escribir una clave que contenga un guion antes de una letra ASCII minúscula, como dataset['user-id'], lanza SyntaxError.
Los valores son cadenas: convierte los números de forma explícita. Asignar null almacena el texto "null", en lugar de eliminar el atributo. Usa delete element.dataset.userId para eliminarlo. Si falta la clave userId, se obtiene undefined.
Esta es una interfaz del HTML Living Standard, no una característica de una edición concreta de ECMAScript. Los motores actuales de los navegadores la admiten; que un repositorio incluya Node 24 no demuestra que haya disponibilidad del DOM.
Ejemplos
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'));Resultado
42 43 string false
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.