What is mdn-data?
The mdn-data npm package provides structured data from MDN Web Docs in a programmable format. It includes data on CSS, HTML, and JavaScript, among other web standards, making it a valuable resource for developers looking to integrate web standards documentation into their projects or tools.
What are mdn-data's main functionalities?
Accessing CSS property data
This feature allows you to access detailed information about CSS properties, such as the 'color' property. The data includes syntax, initial values, and more, useful for building CSS-related tools or documentation generators.
{"const mdnData = require('mdn-data'); console.log(mdnData.css.properties.color);"}
Retrieving HTML element information
With this feature, you can retrieve information about HTML elements, like the anchor ('a') element. This includes attributes, permitted content, and more, which can be used in HTML documentation tools or editors.
{"const mdnData = require('mdn-data'); console.log(mdnData.html.elements.a);"}
Getting JavaScript object data
This allows access to information on JavaScript built-in objects, such as 'Promise'. The data covers methods, properties, and usage, beneficial for creating JS documentation or educational tools.
{"const mdnData = require('mdn-data'); console.log(mdnData.javascript.builtins.Promise);"}
Other packages similar to mdn-data
caniuse-api
Provides browser support data for web technologies from Can I Use. While mdn-data offers structured documentation data, caniuse-api focuses on compatibility and browser support, making it complementary for web development insights.
MDN data
https://github.com/mdn/data
Maintained by the MDN team at Mozilla.
This repository contains general data for Web technologies.
This data is used in MDN documentation, to build
information boxes
or sidebar navigation.
External tools have started to make use of this data as well.
For example, the CSSTree CSS parser.
Repository contents
There's a top-level directory for each broad area covered: for example, "api",
"css", "svg". Inside each of these directories is one or more
JSON files containing the data.
api
Contains data about Web APIs:
- API inheritance (interface inheritance and mixin implementations)
css
Contains data about:
- CSS at-rules
- CSS properties
- CSS selectors
- CSS syntaxes
- CSS types
- CSS units
Read more about CSS data and the format of the files.
l10n
The l10n folder contains localization strings that are used in the various
json files throughout this repository.
Problems?
If you find a problem, please file an issue.
Contributing
We're very happy to accept contributions to this data. Please familiarize yourself
with the schema for the data you're editing, and send us a pull request. See also the Contributing file for more information.
See also