{"id":13440634,"url":"https://github.com/amilajack/eslint-plugin-compat","last_synced_at":"2026-02-25T21:06:46.458Z","repository":{"id":41058916,"uuid":"69679985","full_name":"amilajack/eslint-plugin-compat","owner":"amilajack","description":"Check the browser compatibility of your code","archived":false,"fork":false,"pushed_at":"2024-12-12T20:23:50.000Z","size":8076,"stargazers_count":3123,"open_issues_count":83,"forks_count":110,"subscribers_count":30,"default_branch":"main","last_synced_at":"2025-05-05T22:41:39.468Z","etag":null,"topics":["api","browserslist","caniuse","compat","eslint","plugin","polyfill"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/amilajack.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"github":["amilajack"],"patreon":"amilajack","custom":["https://paypal.me/amilajack","https://venmo.com/amilajack"]}},"created_at":"2016-09-30T15:47:58.000Z","updated_at":"2025-04-29T03:41:15.000Z","dependencies_parsed_at":"2024-04-13T06:42:54.715Z","dependency_job_id":"01de595b-49e7-4e00-95b8-f7defa94e080","html_url":"https://github.com/amilajack/eslint-plugin-compat","commit_stats":{"total_commits":458,"total_committers":46,"mean_commits":9.956521739130435,"dds":"0.47379912663755464","last_synced_commit":"a0c853e260656cb60139f90e3ffc89d025f80969"},"previous_names":["amilajack/eslint-plugin-caniuse"],"tags_count":93,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amilajack%2Feslint-plugin-compat","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amilajack%2Feslint-plugin-compat/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amilajack%2Feslint-plugin-compat/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amilajack%2Feslint-plugin-compat/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/amilajack","download_url":"https://codeload.github.com/amilajack/eslint-plugin-compat/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253002912,"owners_count":21838642,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api","browserslist","caniuse","compat","eslint","plugin","polyfill"],"created_at":"2024-07-31T03:01:24.616Z","updated_at":"2026-02-25T21:06:46.453Z","avatar_url":"https://github.com/amilajack.png","language":"TypeScript","funding_links":["https://github.com/sponsors/amilajack","https://patreon.com/amilajack","https://paypal.me/amilajack","https://venmo.com/amilajack","https://opencollective.com/eslint-plugin-compat","https://opencollective.com/eslint-plugin-compat/contribute","https://opencollective.com/eslint-plugin-compat/organization/0/website","https://opencollective.com/eslint-plugin-compat/organization/1/website","https://opencollective.com/eslint-plugin-compat/organization/2/website","https://opencollective.com/eslint-plugin-compat/organization/3/website","https://opencollective.com/eslint-plugin-compat/organization/4/website","https://opencollective.com/eslint-plugin-compat/organization/5/website","https://opencollective.com/eslint-plugin-compat/organization/6/website","https://opencollective.com/eslint-plugin-compat/organization/7/website","https://opencollective.com/eslint-plugin-compat/organization/8/website","https://opencollective.com/eslint-plugin-compat/organization/9/website"],"categories":["TypeScript","JavaScript","Plugins"],"sub_categories":["Compatibility"],"readme":"# eslint-plugin-compat\n\n[![Test](https://github.com/amilajack/eslint-plugin-compat/actions/workflows/test.yml/badge.svg)](https://github.com/amilajack/eslint-plugin-compat/actions/workflows/test.yml)\n[![Financial Contributors on Open Collective](https://opencollective.com/eslint-plugin-compat/all/badge.svg?label=financial+contributors)](https://opencollective.com/eslint-plugin-compat)\n[![NPM version](https://badge.fury.io/js/eslint-plugin-compat.svg)](http://badge.fury.io/js/eslint-plugin-compat)\n[![npm](https://img.shields.io/npm/dm/eslint-plugin-compat.svg)](https://npm-stat.com/charts.html?package=eslint-plugin-compat)\n[![Backers on Open Collective](https://opencollective.com/eslint-plugin-compat/backers/badge.svg)](#backers)\n[![Sponsors on Open Collective](https://opencollective.com/eslint-plugin-compat/sponsors/badge.svg)](#sponsors)\n\nLint the browser compatibility of your code\n\n![demo of plugin usage](https://raw.githubusercontent.com/amilajack/eslint-plugin-compat/main/img/eslint-plugin-compat-demo.gif)\n\n## Setup\n\n### 1. Install\n\n```bash\nnpm install eslint-plugin-compat\n```\n\n### 2. Update ESLint Config\n\n#### New Config (`eslint.config.mjs`)\n\n```js\nimport compat from \"eslint-plugin-compat\";\n\nexport default [compat.configs[\"flat/recommended\"]];\n```\n\n#### Legacy Config (`.eslintrc.json`)\n\n```jsonc\n{\n  \"plugins\": [\"compat\"],\n  \"extends\": [\"plugin:compat/recommended\"],\n  \"env\": {\n    \"browser\": true,\n  },\n  // ...\n}\n```\n\n### 3. Configure Target Browsers\n\nBrowser targets are configured using [browserslist](https://github.com/browserslist/browserslist). You can configure browser targets in your `package.json`:\n\n#### `package.json`\n\n```jsonc\n{\n  // ...\n  \"browserslist\": [\"defaults\"],\n}\n```\n\nIf no configuration is found, browserslist [defaults to](https://github.com/browserslist/browserslist#queries) `\"\u003e 0.5%, last 2 versions, Firefox ESR, not dead\"`.\n\nSee [browserslist/browserslist](https://github.com/browserslist/browserslist) for more details.\n\n## Adding Polyfills\n\nAdd polyfills to the settings section of your eslint config. Append the name of the object and the property if one exists. Here are some examples:\n\n```jsonc\n{\n  // ...\n  \"settings\": {\n    \"polyfills\": [\n      // Example of marking entire API and all methods and properties as polyfilled\n      \"Promise\",\n      // Example of marking specific method of an API as polyfilled\n      \"WebAssembly.compile\",\n      // Example of API with no property (i.e. a function)\n      \"fetch\",\n      // Example of instance method, must add `.prototype.`\n      \"Array.prototype.push\",\n    ],\n  },\n}\n```\n\n## Linting ES APIs (Experimental)\n\nThis plugin also supports linting the compatibility of ES APIs in addition to Web APIs. This is an experimental feature and is disabled by default. To enable this feature, add the following to your eslint config:\n\n```jsonc\n{\n  // ...\n  \"settings\": {\n    \"lintAllEsApis\": true,\n  },\n}\n```\n\n## Conditional Checks\n\nBy default, feature detection like `if (fetch) { ... }` does not trigger a\nreport. To lint these conditionals anyway, set the following:\n\n```jsonc\n{\n  \"settings\": {\n    \"ignoreConditionalChecks\": true,\n  },\n}\n```\n\n## Configuring for Different Environments\n\nBrowserslist allows specifying [different browser queries for multiple environments](https://github.com/browserslist/browserslist#configuring-for-different-environments). By default, this plugin targets the `production` browserslist environment. To change this default, set the `settings.browserslistOpts.env` property in your eslint config:\n\n**Example**:\n\nA browserslist with multiple environments:\n\n```jsonc\n  \"browserslist\": {\n    \"production\": [\n      \"\u003e 1%\",\n      \"not dead\"\n    ],\n    \"modern\": [\n      \"last 1 chrome version\",\n      \"last 1 firefox version\"\n    ]\n  }\n```\n\nTarget `modern` browserslist environment:\n\n```jsonc\n{\n  \"settings\": {\n    \"browserslistOpts\": {\n      \"env\": \"modern\",\n    },\n  },\n}\n```\n\n## Demo\n\nFor a minimal demo, see [amilajack/eslint-plugin-compat-demo](https://github.com/amilajack/eslint-plugin-compat-demo)\n\n## Inspiration\n\nToolchains for native platforms, like iOS and Android, have had API linting from the start. It's about time that the web had similar tooling.\n\nThis project was inspired by a two hour conversation I had with someone on the experience of web development and if it is terrible or not. The premise they argued was that `x` browser doesn't support `y` feature while `z` browser does. Eventually, I agreed with him on this and made this plugin to save web developers from having to memorize the browser compatibility of WebAPIs.\n\n## Related\n\n- [ast-metadata-inferer](https://github.com/amilajack/ast-metadata-inferer)\n- [compat-db](https://github.com/amilajack/compat-db)\n\n## Contributors\n\n### Code Contributors\n\nThis project exists thanks to all the people who contribute. [[Contribute](CONTRIBUTING.md)].\n\u003ca href=\"https://github.com/amilajack/eslint-plugin-compat/graphs/contributors\"\u003e\u003cimg src=\"https://opencollective.com/eslint-plugin-compat/contributors.svg?width=890\u0026button=false\" /\u003e\u003c/a\u003e\n\n### Financial Contributors\n\nBecome a financial contributor and help us sustain our community. [[Contribute](https://opencollective.com/eslint-plugin-compat/contribute)]\n\n#### Individuals\n\n\u003ca href=\"https://opencollective.com/eslint-plugin-compat\"\u003e\u003cimg src=\"https://opencollective.com/eslint-plugin-compat/individuals.svg?width=890\"\u003e\u003c/a\u003e\n\n#### Organizations\n\nSupport this project with your organization. Your logo will show up here with a link to your website. [[Contribute](https://opencollective.com/eslint-plugin-compat/contribute)]\n\n\u003ca href=\"https://opencollective.com/eslint-plugin-compat/organization/0/website\"\u003e\u003cimg src=\"https://opencollective.com/eslint-plugin-compat/organization/0/avatar.svg\"\u003e\u003c/a\u003e\n\u003ca href=\"https://opencollective.com/eslint-plugin-compat/organization/1/website\"\u003e\u003cimg src=\"https://opencollective.com/eslint-plugin-compat/organization/1/avatar.svg\"\u003e\u003c/a\u003e\n\u003ca href=\"https://opencollective.com/eslint-plugin-compat/organization/2/website\"\u003e\u003cimg src=\"https://opencollective.com/eslint-plugin-compat/organization/2/avatar.svg\"\u003e\u003c/a\u003e\n\u003ca href=\"https://opencollective.com/eslint-plugin-compat/organization/3/website\"\u003e\u003cimg src=\"https://opencollective.com/eslint-plugin-compat/organization/3/avatar.svg\"\u003e\u003c/a\u003e\n\u003ca href=\"https://opencollective.com/eslint-plugin-compat/organization/4/website\"\u003e\u003cimg src=\"https://opencollective.com/eslint-plugin-compat/organization/4/avatar.svg\"\u003e\u003c/a\u003e\n\u003ca href=\"https://opencollective.com/eslint-plugin-compat/organization/5/website\"\u003e\u003cimg src=\"https://opencollective.com/eslint-plugin-compat/organization/5/avatar.svg\"\u003e\u003c/a\u003e\n\u003ca href=\"https://opencollective.com/eslint-plugin-compat/organization/6/website\"\u003e\u003cimg src=\"https://opencollective.com/eslint-plugin-compat/organization/6/avatar.svg\"\u003e\u003c/a\u003e\n\u003ca href=\"https://opencollective.com/eslint-plugin-compat/organization/7/website\"\u003e\u003cimg src=\"https://opencollective.com/eslint-plugin-compat/organization/7/avatar.svg\"\u003e\u003c/a\u003e\n\u003ca href=\"https://opencollective.com/eslint-plugin-compat/organization/8/website\"\u003e\u003cimg src=\"https://opencollective.com/eslint-plugin-compat/organization/8/avatar.svg\"\u003e\u003c/a\u003e\n\u003ca href=\"https://opencollective.com/eslint-plugin-compat/organization/9/website\"\u003e\u003cimg src=\"https://opencollective.com/eslint-plugin-compat/organization/9/avatar.svg\"\u003e\u003c/a\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Familajack%2Feslint-plugin-compat","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Familajack%2Feslint-plugin-compat","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Familajack%2Feslint-plugin-compat/lists"}