+1
Daily
5,793
stars
2,693
forks
289
watchers
22,566
prs
6,657
issues
516
releases
README
@mdn/browser-compat-data
https://github.com/mdn/browser-compat-data
The browser-compat-data ("BCD") project contains machine-readable browser (and JavaScript runtime) compatibility data for Web technologies, such as Web APIs, JavaScript features, CSS properties and more. Our goal is to document accurate compatibility data for Web technologies, so web developers may write cross-browser compatible websites easier. BCD is used in web apps and software such as MDN Web Docs, CanIUse, Visual Studio Code, WebStorm and more.
Read how this project is governed.
Chat with us on Matrix at chat.mozilla.orgmdn!
Are you interested in contributing to this project? Check out the Contributing to browser-compat-data documentation.
[!TIP]
Looking for something? Consult the alphabetical index of the project documentation.
Installation and Import
NodeJS
You can install @mdn/browser-compat-data as a node package.
bash
npm install @mdn/browser-compat-data
...or...
yarn add @mdn/browser-compat-data
Then, you can import BCD into your project with either import or require():
js
// ESM with Import Attributes (NodeJS 20+)
import bcd from '@mdn/browser-compat-data' with { type: 'json' };
// ...or...
const { default: bcd } = await import('@mdn/browser-compat-data', {
with: { type: 'json' },
});
// ...or...
// ESM with Import Assertions (NodeJS 16+)
import bcd from '@mdn/browser-compat-data' assert { type: 'json' };
// ...or...
const { default: bcd } = await import('@mdn/browser-compat-data', {
assert: { type: 'json' },
});
// ...or...
// ESM Wrapper for older NodeJS versions (NodeJS v12+)
import bcd from '@mdn/browser-compat-data/forLegacyNode';
// ...or...
const { default: bcd } = await import('@mdn/browser-compat-data/forLegacyNode');
// ...or...
// CommonJS Module (Any NodeJS)
const bcd = require('@mdn/browser-compat-data');
Deno/Browsers
You can import @mdn/browser-compat-data using a CDN.
js
// ESM with Import Attributes (Deno 1.37+)
import bcd from 'https://unpkg.com/@mdn/browser-compat-data' with { type: 'json' };
// ...or...
const { default: bcd } = await import(
'https://unpkg.com/@mdn/browser-compat-data',
{
with: { type: 'json' },
}
);
// ...or...
// ESM with Import Assertions (Deno 1.17+)
import bcd from 'https://unpkg.com/@mdn/browser-compat-data' assert { type: 'json' };
// ...or...
const { default: bcd } = await import(
'https://unpkg.com/@mdn/browser-compat-data',
{
assert: { type: 'json' },
}
);
// ...or...
// Fetch Method (Deno 1.0+)
const bcd = await fetch('https://unpkg.com/@mdn/browser-compat-data').then(
(response) = response.json(),
);
Other Languages
You can obtain the raw compatibility data for @mdn/browser-compat-data using a CDN and loading the data.json file included in releases.
https://unpkg.com/@mdn/browser-compat-data/data.json
Usage
Once you have imported BCD, you can access the compatibility data for any feature by accessing the properties of the dictionary.
js
// Grab the dTop issues
#6367Data guidelines for Web IDL iterable, setlike and maplike declarations28 comments · 2020-07-02#7849Tag everything with worker support?18 comments · 2020-12-15#22126api.SpeechRecognition - Edge does not actually support SpeechRecognition Web Speech API16 comments · 2024-01-31#17726types: filter-function: drop-shadow() — Not actually supported well by Safari (very buggy)13 comments · 2022-09-07#6971Add support data for image formats/codecs? (especially WebP) And media (video/audio) formats/codecs too?13 comments · 2020-10-16#1531Investigate if we still need status.standards_track if spec_urls are populated throughout the repo13 comments · 2018-03-17#28693css.types.color.color-mix - Add support data for optional colorspace argument11 comments · 2025-12-18#16598Multiple statements with flags11 comments · 2022-06-08
Latest release
v8.1.9 v8.1.9 2026-11-12Removals - api.SpeechGrammarList.addFromURI (31089) Additions - api.CredentialsContainer.create.mediation_option (31062) - api.FontFace.sizeAdjust (30922) - api.SpeechGrammarList.addFromUri (31089) - api.SVGScriptElement.referrerPolicy (31035) - api.WebTransport.exportKeyingMaterial.outputLength_parameter (30999) - api.WebTransport.WebTransport.options_datagramsReadableType_parameter (31030) - api.WebTransport.WebTransport.options_headers_parameter (31031) - browsers.chrome_android.releases.160 (31032) - browsers.chrome.releases.160 (31032) - browsers.edge.releases.160 (31068) - browsers.f