eslint-plugin-escompat

eslint-plugin-escompat

This plugin will report eslint errors for code which - if left untranspiled - will not work in some browsers.

This is useful if you intend to ship code without first using a transpiler, such as Babel.

This won't lint for features that can be polyfilled. For that you can use eslint-plugin-compat.

Installation

npm install --save-dev eslint-plugin-escompat

Add "escompat" to .eslintrc "plugins" section, add "browser": true to "env", then configure the individual "escompat/*" rules.

Alternatively, you can use the recommended configuration which will do this for you, with the "escompat/*" rules reporting errors (as in the snippet above).

// .eslintrc
{
  "extends": ["plugin:escompat/recommended"]
}

TypeScript Users

Aside from the recommended config, there is also the typescript config which can be used if you're using TypeScript. The TypeScript config only enables some of the rules, avoiding enabling rules for which typescript safely transpiles down to a more compatible syntax. To enable the typescript config, simply add the following to your eslint config:

// .eslintrc
{
  "extends": ["plugin:escompat/typescript"]
}

Targeting Browsers

eslint-plugin-escompat uses the browserslist configuration in package.json

If you have a browserlist, is is safe to enable all of these rules - as any that do not coincide with your chosen browsers will be turned off automatically.

See browserslist/browserslist for configuration. Here's some examples:

// Simple configuration (package.json)
{
  // ...
  "browserslist": ["last 1 versions", "not ie <= 8"],
}

// Use development and production configurations (package.json)
{
  // ...
  "browserslist": {
    "development": ["last 2 versions"],
    "production": ["last 4 versions"]
  }
}

:bulb: You can also define browsers in a separate browserslist file

Rules

• no-async-generator ✔️
• no-async-iteration ✔️
• no-bigint ✔️ 🔹
• no-bind-operator ✔️ 🔹
• no-computed-class-fields ✔️ 🔹
• no-do-expression ✔️ 🔹
• no-dynamic-import ✔️ 🔹
• no-edge-destructure-bug ✔️ 🔹
• no-exponentiation-operator ✔️
• no-nullish-coalescing ✔️
• no-numeric-separators ✔️
• no-object-rest-spread ✔️
• no-optional-catch ✔️
• no-optional-chaining ✔️
• no-pipeline-operator ✔️ 🔹
• no-private-class-fields ✔️
• no-public-instance-class-fields ✔️
• no-public-static-class-fields ✔️
• no-regexp-lookbehind ✔️ 🔹
• no-regexp-named-groups ✔️ 🔹
• no-regexp-s-flag ✔️ 🔹

Key:

✔️ = enabled in plugin:escompat/recommended config. 🔹 = enabled in plugin:escompat/typescript config.

Inspiration

This project was largely inspired by the great eslint-plugin-compat library.