eslint-plugin-react-etc

More ESLint rules for React

Usage no npm install needed!

<script type="module">
  import eslintPluginReactEtc from 'https://cdn.skypack.dev/eslint-plugin-react-etc';
</script>

README

eslint-plugin-react-etc

GitHub License NPM version Downloads Build status dependency status devDependency Status peerDependency Status

This package will eventually contain a bunch of ESLint rules - some of which will require the use of TypeScript - to highlight potential problems or poor practices in React. As a starting point, there is a single rule - prefer-usememo - but you can expect more rules to be added in future releases, as I have a bunch of ideas that I want to explore.

Some of the rules will be rather opinionated and won't be included in the recommended configuration. Developers can decide for themselves whether they want to enable opinionated rules.

Install

Install the package using npm:

npm install eslint-plugin-react-etc --save-dev

Some of the rules in this package require the ESLint TypeScript parser (indicated in the table below). If you intend to use those rules, install the parser using npm:

npm install @typescript-eslint/parser --save-dev

And then configure the parser and the parserOptions for ESLint. Here, I use a .eslintrc.js file for the configuration:

const { join } = require("path");
module.exports = {
  parser: "@typescript-eslint/parser",
  parserOptions: {
    ecmaVersion: 2020,
    project: join(__dirname, "./tsconfig.json"),
    sourceType: "module"
  },
  plugins: ["react-etc"],
  extends: [],
  rules: {
    "react-etc/prefer-usememo": "error"
  }
};

Or, using the recommended configuration:

const { join } = require("path");
module.exports = {
  parser: "@typescript-eslint/parser",
  parserOptions: {
    ecmaVersion: 2019,
    project: join(__dirname, "./tsconfig.json"),
    sourceType: "module"
  },
  extends: ["plugin:react-etc/recommended"],
};

Rules

The package includes the following rules:

Rule Description TS-only Recommended
prefer-usememo Forbids useEffect when useMemo should suffice. It's an implementation of the rule that Sophie Alpert mentioned in this tweet. No Yes
no-unstable-context-selector Forbids passing functions that return unstable values to useContextSelector. No Yes