{"_id":"@andrewsavage1/browser-compat-data","name":"@andrewsavage1/browser-compat-data","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"main":"data.json","exports":{".":"./data.json","./forLegacyNode":"./legacynode.mjs"},"types":"index.ts","name":"@andrewsavage1/browser-compat-data","version":"0.1.0","description":"Browser compatibility data provided by MDN Web Docs","repository":{"type":"git","url":"git+https://github.com/andrewsavage1/browser-compat-data.git"},"keywords":["bcd","browser-compat-data","browser","compatibility","data","mdn","mozilla"],"author":{"name":"andrewsavage1"},"license":"CC0-1.0","bugs":{"url":"https://github.com/andrewsavage1/browser-compat-data/issues"},"homepage":"https://github.com/andrewsavage1/browser-compat-data#readme","gitHead":"f1ec5b559d2185925e48c7b2a80669417f005295","_id":"@andrewsavage1/browser-compat-data@0.1.0","_nodeVersion":"18.7.0","_npmVersion":"8.19.2","dist":{"integrity":"sha512-LXgguoKPWO9j+7N1GW/oVWbZ9elJnI7qBwHc1ESbRyH5Vhvx1UDGIJb5D5yYTVTLzqhJwHpDE+hT5xzYnNbx3Q==","shasum":"7aa0e007f65e471739e1028f1b1b160d91d9af84","tarball":"https://registry.npmjs.org/@andrewsavage1/browser-compat-data/-/browser-compat-data-0.1.0.tgz","fileCount":7,"unpackedSize":12194748,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIQCqNLHTyZ77Xrq3dPti8SsYhaGwR8NTs1OhRpNuK8onZgIgRBNlULnyavIUGxSeLja6lPp0xBAbTAItxBJhp7kEFnw="}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJjSYYcACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2VmpOcQ/9GQiy1aZ2E1thMD7Wq0Qg0cIRkvXmJJSMOou1+mb7ItW1ywlg\r\n1+UgRc0M0pwpmaBAN2+nMHhI7uLf38Hc1lAklDpeoM2S82PG3b2+tMuL2SCf\r\nNPzg+qIpwnjX0ZesGvqVDarBlURi3+nzNcqVkb5WycPxBZsdlOE87K9pzA+D\r\n5UthU1hIDv6CXLJaZJGBC2Gryb9OVXJThIGBlC7gQiggY71xrtpbSxXcPhO6\r\nhfv/tyKGoC1UwXTs+10WFZ7K9DOz7CjHdt69Fb+kfVx1IwCbMiaVv+NuDNG0\r\nutcG0LdMiuB6jfBmmkfDT7yiIa1YOuD5/t6M5U2qLf6WFPaKxbgA3V9jVWP2\r\npmHLKBU2KefWLdFfLUvHEQ8Or5CsaX3DK08FNOoyUSyCn36bXu+45KCjcfqi\r\n6SScqmg4Q+ZS2NpOn374PdTk7wh7kinnFO2hv1z85itEPHWY1MWkfYrfk5Qh\r\nCiAEetkk2FuEkuDrIqYUGtKL3YqpvmywhYW4eJac2SQUW1tcFQuQdulnSigl\r\nLpYq0sPqIS2xl9MHzU2wMIIeaycfM9cE+InYRsfnhYufuacBIQLUZdPcY+9P\r\ntzxvH2pYTqM+QyoRbwuDYWrQa9BdyBzjswlv2xLaQU8Hjcc0MzWVdb27x53h\r\nW5XaBWUIu885KvNt117qg7jcEn13NBMAkDg=\r\n=zBh3\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"andrewsavage1","email":"andrewsavage@google.com"},"directories":{},"maintainers":[{"name":"andrewsavage1","email":"andrewsavage@google.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/browser-compat-data_0.1.0_1665762843837_0.8609073730525467"},"_hasShrinkwrap":false}},"time":{"created":"2022-10-14T15:54:03.763Z","0.1.0":"2022-10-14T15:54:04.148Z","modified":"2022-10-14T15:54:04.290Z"},"maintainers":[{"name":"andrewsavage1","email":"andrewsavage@google.com"}],"description":"Browser compatibility data provided by MDN Web Docs","homepage":"https://github.com/andrewsavage1/browser-compat-data#readme","keywords":["bcd","browser-compat-data","browser","compatibility","data","mdn","mozilla"],"repository":{"type":"git","url":"git+https://github.com/andrewsavage1/browser-compat-data.git"},"author":{"name":"andrewsavage1"},"bugs":{"url":"https://github.com/andrewsavage1/browser-compat-data/issues"},"license":"CC0-1.0","readme":"# `@mdn/browser-compat-data`\n\n[https://github.com/mdn/browser-compat-data](https://github.com/mdn/browser-compat-data)\n\nThe `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](https://developer.mozilla.org/en-US/Add-ons/WebExtensions/Browser_support_for_JavaScript_APIs), CanIUse, Visual Studio Code, WebStorm and [more](#Projects-using-the-data).\n\nRead how this project is [governed](GOVERNANCE.md).\n\nChat with us on Matrix at [chat.mozilla.org#mdn](https://chat.mozilla.org/#/room/#mdn:mozilla.org)!\n\n## Installation and Import\n\n### NodeJS\n\nYou can install `@mdn/browser-compat-data` as a node package.\n\n```bash\nnpm install @mdn/browser-compat-data\n# ...or...\nyarn add @mdn/browser-compat-data\n```\n\nThen, you can import BCD into your project with either `import` or `require()`:\n\n```js\n// ESM with Import Assertions (NodeJS 16+)\nimport bcd from '@mdn/browser-compat-data' assert { type: 'json' };\n\n// ...or...\n\n// ESM Wrapper for older NodeJS versions (NodeJS v12+)\nimport bcd from '@mdn/browser-compat-data/forLegacyNode';\n\n// ...or...\n\n// CommonJS Module (Any NodeJS)\nconst bcd = require('@mdn/browser-compat-data');\n```\n\n### Deno/Browsers\n\nYou can import `@mdn/browser-compat-data` using a CDN.\n\n```js\nimport bcd from 'https://unpkg.com/@mdn/browser-compat-data' assert { type: 'json' };\n```\n\n### Other Languages\n\nYou can obtain the raw compatibility data for `@mdn/browser-compat-data` using a CDN and loading the `data.json` file included in releases.\n\n```py\nhttps://unpkg.com/@mdn/browser-compat-data/data.json\n```\n\n## Usage\n\nOnce you have imported BCD, you can access the compatibility data for any feature by accessing the properties of the dictionary.\n\n```js\n// Grab the desired support statement\nconst support = bcd.css.properties.background.__compat;\n// returns a compat data object (see schema)\n\n// You may use any syntax to obtain dictionary items\nconst support = bcd['api']['Document']['body']['__compat'];\n```\n\n## Package contents\n\nThe `@mdn/browser-compat-data` package contains a tree of objects, with support and browser data objects at their leaves. There are over 12,000 features in the dataset; this documentation highlights significant portions, but many others exist at various levels of the tree.\n\nThe definitive description of the format used to represent individual features and browsers is the [schema definitions](schemas/).\n\nApart from the explicitly documented objects below, feature-level support data may change at any time. See [_Semantic versioning policy_](#Semantic-versioning-policy) for details.\n\nThe package contains the following top-level objects:\n\n### `__meta`\n\nAn object containing the following package metadata:\n\n- `version` - the package version\n- `timestamp` - the timestamp of when the package version was built\n\n### [`api`](api)\n\nData for [Web API](https://developer.mozilla.org/en-US/docs/Web/API) features.\n\n### [`browsers`](browsers)\n\nData for browsers and JavaScript runtimes. See the [browser schema](schemas/browsers-schema.md) for details.\n\n### [`css`](css)\n\nData for [CSS](https://developer.mozilla.org/en-US/docs/Web/CSS) features, including:\n\n- `at-rules` - at-rules (e.g. `@media`)\n- `properties` - Properties (e.g. `background`, `color`, `font-variant`)\n- `selectors` - Selectors (such as basic selectors, combinators, or pseudo elements)\n- `types` - Value types for rule values\n\n### [`html`](html)\n\nData for [HTML](https://developer.mozilla.org/en-US/docs/Web/HTML) features, including:\n\n- `elements` - Elements\n- `global_attributes` - Global attributes\n- `manifest` - Web App manifest keys\n\n### [`http`](http)\n\nData for [HTTP](https://developer.mozilla.org/en-US/docs/Web/HTTP) features, including:\n\n- `headers` - Request and response headers\n- `methods` - Request methods\n- `status` - Status codes\n\n### [`javascript`](javascript)\n\nData for JavaScript language features, including:\n\n- `builtins` - Built-in objects\n- `classes` - Class definition features\n- `functions` - Function features\n- `grammar` - Language grammar\n- `operators` - Mathematical and logical operators\n- `statements` - Language statements and expressions\n\n### [`mathml`](mathml)\n\nData for [MathML](https://developer.mozilla.org/en-US/docs/Web/MathML) features, including:\n\n- `elements` - Elements\n\n### [`svg`](svg)\n\nData for [SVG](https://developer.mozilla.org/en-US/docs/Web/SVG) features, including:\n\n- `attributes` - Attributes\n- `elements` - Elements\n\n### [`webdriver`](webdriver)\n\nData for [WebDriver](https://developer.mozilla.org/en-US/docs/Web/WebDriver) features.\n\n### [`webextensions`](webextensions)\n\nData for [WebExtensions](https://developer.mozilla.org/en-US/Add-ons/WebExtensions) features, including:\n\n- `api` - WebExtension-specific APIs\n- `manifest` - `manifest.json` keys\n\n## Semantic versioning policy\n\nFor the purposes of [semantic versioning](https://semver.org/) (SemVer), the public API consists of:\n\n- The high-level namespace objects documented in [_Package contents_](#Package-contents)\n- The schema definitions for browser and support data structures\n- The TypeScript definitions\n\nThe details of browser compatibility change frequently, as browsers ship new features, standards organizations revise specifications, and Web developers discover new bugs. We routinely publish updates to the package to reflect these changes.\n\nYou should expect lower-level namespaces, feature data, and browser data to be added, removed, or modified at any time. That said, we strive to communicate changes and preserve backward compatibility; if you rely on a currently undocumented portion of the package and want SemVer to apply to it, please [open an issue](https://github.com/mdn/browser-compat-data/issues).\n\n## Issues?\n\nIf you find a problem with the compatibility data (such as incorrect version numbers) or there is a new web feature you think we should document, please [file a bug](https://github.com/mdn/browser-compat-data/issues/new).\n\n## Contributing\n\nThank you for your interest in contributing to this project! See [Contributing to browser-compat-data](/docs/contributing.md) for more information.\n\n## Projects using the data\n\nHere are some projects using the data, as an [npm module](https://www.npmjs.com/browse/depended/@mdn/browser-compat-data) or directly:\n\n- [Add-ons Linter](https://github.com/mozilla/addons-linter) - the Add-ons Linter is used on [addons.mozilla.org](https://addons.mozilla.org/) and the [web-ext](https://github.com/mozilla/web-ext/) tool. It uses browser-compat-data to check that the Firefox version that the add-on lists support for does in fact support the APIs used by the add-on.\n- [caniuse](https://caniuse.com/) - In addition to the existing caniuse database, caniuse includes features from the MDN BCD project, formatted and interactive like any other caniuse support table.\n- [CanIUse Embed](https://caniuse.bitsofco.de/) - Thanks to the inclusion of MDN BCD data in caniuse, this embed tool allows for embedding BCD data into any project.\n- [Compat Report](https://addons.mozilla.org/en-US/firefox/addon/compat-report/) - Firefox Add-on that shows compatibility data for the current site in the developer tools.\n- [compat-tester](https://github.com/SphinxKnight/compat-tester) - Scan local documents for compatibility issues.\n- [Visual Studio Code](https://code.visualstudio.com) - Shows the compatibility information in [the code completion popup](https://code.visualstudio.com/updates/v1_25#_improved-accuracy-of-browser-compatibility-data).\n- [webhint.io](https://webhint.io/docs/user-guide/hints/hint-compat-api/) - Hints to check if your CSS HTML and JavaScript have deprecated or not broadly supported features.\n- [WebStorm](https://www.jetbrains.com/webstorm/whatsnew/#v2019-1-html-and-css) - JavaScript IDE allowing you to check whether all CSS properties you use are supported in the target browser version.\n- [Hexo Plugin: hexo-compat-report](https://github.com/TimDaub/hexo-compat-report) - Allows to embed MDN's compatibility table in a hexo blog post.\n\n## Acknowledgments\n\nThanks to:\n\n<table>\n  <tr align=\"center\">\n    <td>\n      <img\n        src=\"https://user-images.githubusercontent.com/498917/52569900-852b3080-2e12-11e9-9bd0-f1e256b13e53.png\"\n        height=\"86\"\n        alt=\"BrowserStack\"\n      />\n      <p>\n        The\n        <a href=\"https://www.browserstack.com/open-source\"\n          >BrowserStack Open Source Program</a\n        >\n        for testing services\n      </p>\n    </td>\n    <td>\n      <img\n        src=\"https://opensource.saucelabs.com/images/opensauce/powered-by-saucelabs-badge-white.png?sanitize=true\"\n        height=\"86\"\n        alt=\"Testing Powered By Sauce Labs\"\n      />\n      <p>\n        <a href=\"https://opensource.saucelabs.com/\">Sauce Labs Open Source</a\n        >\n        for testing services\n      </p>\n    </td>\n  </tr>\n</table>\n","readmeFilename":"README.md"}