mdn-data

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.

README

Welcome to MDN data

Note We are in the process of deprecating the mdn/data package in favor of w3c/webref. If you depend on this project, let us know in our community GitHub discussions. Thank you.

This repository contains general data for Web technologies and is maintained by the MDN team at Mozilla.

Repository contents

The data in this repository is used in MDN Web Docs to build information boxes and sidebar navigation. External tools make use of this data as well, for example, the CSSTree CSS parser.

There's a top-level directory for each broad area covered: for example, api and css. 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 functions
• CSS properties
• CSS selectors
• CSS syntaxes
• CSS types
• CSS units

For more information, see the CSS data documentation and the Updating CSS JSON DB guide.

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 the CONTRIBUTING.md document for more information.

See also

• https://github.com/mdn/browser-compat-data for compatibility data for Web technologies

Changelog

2.12.0 (2024-10-23)

Features

• add data for interpolate-size property (#773) (43873fc)
• added auto value to text-emphasis-position property (#772) (c4ac978)
• rename inset-area to position-area (#769) (d2b8857)
• update text-wrap to be a shorthand property (#774) (2213097)
• update syntax for Anchor Positioning related properties (#770) (5f5c637)

Bug Fixes

• add mdn url for CSS offset-anchor (#759) (991632c)
• link: fix link to stacking context (#768) (793cb7a)

Miscellaneous

• css: remove column-fill: balance-all (#775) (97b010c)
• update linear-gradient syntax to use optional color-interpolation-method (#766) (9d0f4c5)