Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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.

Fuentes