coderef

DatasetBaseline · Widely available

The dataset API attaches and accesses custom data on elements, using either the dataset property of HTMLElement or attributes prefixed with data-.

Supported in all major browsers for at least 30 months — safe to use without fallbacks. Baseline since Jul 29, 2015. Widely available since Jan 29, 2018.

How to use ↓Compare browsers

Browser support

DesktopChrome
1–6Not supported
7+Supportedsince Oct 19, 2010
Current: 155
Edge
12+Supportedsince Jul 29, 2015
Current: 154
Firefox
1–5Not supported
6+Supportedsince Aug 16, 2011
Current: 157
Safari
1–5Not supported
5.1+Supportedsince Jul 20, 2011
Current: 27
MobileChrome Android
18+Supportedsince Jun 27, 2012
Current: 155
Firefox Android
4–5Not supported
6+Supportedsince Aug 16, 2011
Current: 157
Safari iOS
1–4.2Not supported
5+Supportedsince Oct 12, 2011
Current: 27

How to use

This feature is Baseline widely available — use it freely, no fallback needed.

Example

Full syntax and examples are on MDN: DOMStringMap.

Feature detection

JS · check before using
if ("HTMLElement" in globalThis && "dataset" in HTMLElement.prototype) {
  // HTMLElement.dataset is available
}

Documentation (MDN)

Specification

Usage share

Sub-features

Support for each part of the feature (4). The overall table above shows when the whole feature works.

Sub-featureChromeEdgeFirefoxSafariChrome AndroidFirefox AndroidSafari iOS
DOMStringMap71265.11865
HTMLElement.dataset71265.11865
MathMLElement.dataset1091097113.11097913.4
SVGElement.dataset5517515.155515