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.13.0 (2024-12-05)

Features

• css: Add data for lighting-color, flood-color, flood-opacity (#787) (2e42c31)
• css: Add data for stop-color & stop-opacity (#782) (9398267)
• css: add mdn_url for features with documentations (#803) (dd04e07)
• css: Add missing <anchor-name> syntax for position-anchor property (#792) (350f183)
• css: Add missing <position-area> syntax for position-area property (#793) (3722a02)
• css: Add missing <try-size> syntax for position-try-order property (#796) (0b93566)
• css: Add missing <try-tactic> syntax for position-try-fallbacks property (#795) (76584aa)
• css: Add missing syntax &lt;coord-box&gt; <offset-path> for offset-path property (#790) (8438947)
• css: Add missing syntax <dasharray> for stroke-dasharray (#791) (df08f67)
• css: add missing syntax for offset-path property (8438947)
• css: Add missing syntax for stroke property (#783) (89c2196)
• css: Allow at-rule descriptors also contain mdn_url key (#805) (7ebbdfa)
• css: Fix/Add synatx for font-palette <palette-identifier> palette-mix() (#785) (d572bcb)
• css: make at-rule descriptor also contain mdn_url key (7ebbdfa)
• css: remove non-supported caption-side values (#818) (f0b8774)
• css: Support for word-break:auto-phrase (#810) (12e6074)
• css: sync at-rule status per bcd (9c8b9eb)
• css: Sync at-rule status per bcd (#800) (9c8b9eb)
• css: sync property status per bcd (06fa694)
• css: Sync property status per bcd (#801) (06fa694)
• css: sync selector status per bcd (31d4ebe)
• css: Sync selector status per bcd (#799) (31d4ebe)
• css: Update <alpha-value> usage (#784) (87dc78b)
• css: Update padding properties (#816) (8a9f3e2)
• css: Update syntax for outline-style (#808) (14605dc)
• css: Update syntax for at_font-palette-values/override-colors (#780) (6f8e474)
• css: Update syntax for fit-content() (#814) (cd9f7ce)
• css: Update syntax for margin properties (#815) (8d9f939)
• css: Update syntax for sizing properties (#813) (cd06f28)

Bug Fixes

• add missing syntax for [@scope](https://github.com/scope) (0a8c8b6)
• css: Add missing syntax <single-animation-composition> for animation-composition (#789) (e76c914)
• css: Add missing syntax for [@scope](https://github.com/scope) (#788) (0a8c8b6)
• css: fill-opacity should accept percentages (#786) (42dcf9e)
• css: Fix incorrect mdn_url (#804) (f432647)
• css: Fix syntax for scroll-timeline-name (#809) (f050f8b)
• css: Fix syntax for text-wrap (#781) (1b708b3)
• css: Fix syntax for white-space (#802) (2cc41d0)
• css: make functions syntax consistent (#817) (eeffb3f)
• css: Mark <shape> type as obsolete (#797) (c8067ba)
• css: mark element() as experimental (10594fb)
• css: Mark element() as experimental (#798) (10594fb)