How to make ESLint work with Prettier avoiding conflicts and problems

pixari

Raffaele Pizzari

Posted on September 25, 2020

How to make ESLint work with Prettier avoiding conflicts and problems

(check out my blog)

Having prettier and ESLint up and running on your project can be very useful and can save us a lot of time by identifying static errors as we introduce them into the code and assure a consistent style to your files.

Prettier is a famous "code formatter" which ensures that all outputted code conforms to a consistent style.

ESLint is a JavaScript linting utility which performs static analysis in order to find problematic patterns or code that doesn't adhere to certain style guidelines.

Prettier and ESlint, two hearths one love

It is very common nowadays to use them both at the same time.
Unfortunately, it is very easy to have configuration errors that often generate really annoying conflicts.

In this post I try to give a couple of indications to configure VSCode properly and avoid problems and conflicts.

Prerequisites

-Visual Studio Code
-VS Code ESLint plugin

What to do

  1. First of all you have to install ESLint plugin in VS Code. Either you can use the extension tab in VS Code or just the links provided in the “Prerequisites” section of this post.
  2. Then you have to install in your project Prettier and ESLint as node modules:
npm install --save-dev eslint prettier
Enter fullscreen mode Exit fullscreen mode
  1. Now it’s time to create a config file for ESLInt:
./node_modules/eslint/bin/eslint.js --init
Enter fullscreen mode Exit fullscreen mode

Or if you installed it globally you can use:

eslint --init 
Enter fullscreen mode Exit fullscreen mode

Pick the following options:

  • To check syntax, find problems, and enforce code style
  • JavaScript modules (import/export)
  • None of these
  • TypeScript: No
  • Browser or Node, as you prefer
  • Use a popular style guide
  • Airbnb (personally I really like this style guide)
  • JavaScript
  • Yes (install all dependencies)

After this process, you’ll find a new file in your root folder: .eslintrc.js

My file looks like this:

module.exports = {
  env: {
    browser: true,
    es2021: true,
  },
  extends: [
    airbnb-base,
  ],
  parserOptions: {
    ecmaVersion: 12,
    sourceType: module,
  },
  rules: {
  },
};
Enter fullscreen mode Exit fullscreen mode

This is the config file for ESLint.

  1. Now it’s time to create a config file for prettier:
// .prettierrc.js
module.exports = {
  trailingComma: "es5",
  tabWidth: 2,
  semi: true,
  singleQuote: true,
};

Enter fullscreen mode Exit fullscreen mode

One of the most common problem people are experiencing with Prettier/ESLint is having conflicting warnings and lot of red lining errors.

A good way to avoid this problem is using Prettier as a ESLint plugin.

That’s why you have to install a special plugin called “eslint-plugin-prettier” ad dev dependency:

npm install --save-dev eslint-plugin-prettier
Enter fullscreen mode Exit fullscreen mode

Once it’s installed, you have to tell ESLint to use Prettier as a plugin:

module.exports = {
  env: {
    es6: true,
    browser: true,
    es2021: true,
  },
  extends: [airbnb-base],
  parserOptions: {
    ecmaVersion: 12,
    sourceType: module,
  },
  rules: {
    prettier/prettier: error,
  },
  plugins: [prettier],
};

Enter fullscreen mode Exit fullscreen mode

At this point, you have both Prettier and ESLint up and running on your code.

Even if it’s working, it could be that some rules will conflict.
To avoid this problem, you have to turns off all rules that are unnecessary or might conflict with Prettier.

npm install --save-dev eslint-config-prettier
Enter fullscreen mode Exit fullscreen mode

Once it’s installed, you have to update your .eslintrc.js file:

module.exports = {
  env: {
    es6: true,
    browser: true,
    es2021: true,
  },
  extends: ['airbnb-base', 'prettier'],
  parserOptions: {
    ecmaVersion: 12,
    sourceType: 'module',
  },
  rules: {
    'prettier/prettier': 'error',
  },
  plugins: ['prettier'],
};

Enter fullscreen mode Exit fullscreen mode

Yeah! You did it!

In your project now you have ESLint and Prettier working perfectly at the same time.
Prettier runs as a plugin of ESLint and thanks to the special configuration it won’t conflict with it.

You can check a working example on this repo: GitHub - codejourneys-org/eslint-prettier

If you have any questions please do not hesitate to leave a comment or join a great community of Front-End developers 😃 : CodeJourneys.org

💖 💪 🙅 🚩
pixari
Raffaele Pizzari

Posted on September 25, 2020

Join Our Newsletter. No Spam, Only the good stuff.

Sign up to receive the latest update from our blog.

Related