eslint-config-adjunct

_A reasonable collection of plugins to use alongside your main esLint configuration_

This config is designed to be used alongside any of the major esLint configs, such as airbnb, standard or eslint:recommended. It provides a range of useful plugins that are often too time-consuming to setup and provides an easy way to install just the plugins you need, based on your project's dependencies.

Install

To install this config, run the following command.

``sh
npm install eslint-config-adjunct --save-dev
`

Configure

Extend your .eslintrc, with adjunct, which should be the last item in the extends array. For example if your using eslint-config-airbnb as your main rule set, your .eslintrc should look like the following. For more advanced use cases see the example configurations for TypeScript and Vue.

`json
{
"extends": ["airbnb", "adjunct"]
}
`

You can now include html, json and markdown in the list of files passed to eslint to lint any JavaScript contained.

`json
{
"scripts": {
"eslint": "eslint --color --ext .html,.js,.json,.jsx,.md . src",
"eslint:fix": "npm run eslint -- --fix"
}
}
`

Install Dependencies

After you have configured eslint to include this package, the first time you run eslint it will output the npm command to install the dependencies required for your project. Cut'n'paste this command into the console, and you are then ready to start linting.

Plugins

$3

These two plugins provide a range of code quality rules:

- eslint-plugin-sonarjs
- eslint-plugin-unicorn

$3

The following plugins expand esLint to work with json files, and lint JavaScript contiained in HTML and MarkDown:

- eslint-plugin-html
- eslint-plugin-json
- eslint-plugin-markdown

_When linting code snippets in Markdown files, a few rules relating to globals and unused vars are disabled._

$3

These plugins will be loaded in based on your project dependencies in package.json. If a supported library is part of your project then it's related esLint plugins will be loaded. The following packages are supported:

- eslint-plugin-fsa
- eslint-plugin-lodash
- eslint-plugin-lodash-fp
- eslint-plugin-ramda
- eslint-plugin-react-redux
- eslint-plugin-redux-saga

$3

The following esLint plugins enforce good coding practices:

- eslint-plugin-const-case
- eslint-plugin-array-func
- eslint-plugin-eslint-comments
- eslint-plugin-no-constructor-bind
- eslint-plugin-no-use-extend-native
- eslint-plugin-optimize-regex
- eslint-plugin-promise
- eslint-plugin-simple-import-sort
- eslint-plugin-switch-case

$3

If prettier is installed, any rules that may conflict with Prettier will be disabled. The plugin should read you Prettier config from your project's root.

- eslint-config-prettier

The prettier configs for different eslint plugins are also automatically included based on which eslint plugins have been installed into your project.

$3

These plugins add code security rules to esLint:

- eslint-plugin-no-secrets
- eslint-plugin-no-unsanitized
- eslint-plugin-pii
- eslint-plugin-security
- eslint-plugin-xss

$3

Test plugins are loaded based on which testing tools you have listed in devDependencies of package.json. The following test plugins are supported:

- eslint-plugin-ava
- eslint-plugin-chai-expect
- eslint-plugin-chai-friendly
- eslint-plugin-cypress
- eslint-plugin-jasmine
- eslint-plugin-jest
- eslint-plugin-jest-async
- eslint-plugin-mocha
- eslint-plugin-mocha-cleanup
- eslint-plugin-qunit
- eslint-plugin-testing-library

_For test files a few rules are turned off, to better to support normal unit test code styles._

Rules

In the most part the default rules are used for the plugins listed above, with the following exceptions.

$3

Adds the fallthrough: 'never' option to the newline-between-switch-case rule.

`js
// Good

switch (foo) {
case 1:
something()
break

case 2:
case 3:
somethingElse()
break

default:
defaultThing()
}
``

$3

The following rules are disabled due to them being considered unduly restrictive or unhelpful.

- jest/no-disabled-tests
- react-redux/prefer-separate-component-file
- redux-saga/no-unhandled-errors
- lodash/prefer over native rules
- lodash-fp/use-fp
- unicorn/no-array-for-each
- unicorn/no-fn-reference-in-iterator
- unicorn/no-array-for-each
- unicorn/no-reduce
- unicorn/no-null
- unicorn/prefer-number-properties
- unicorn/prefer-optional-catch-binding
- unicorn/prevent-abbreviations

The following rules are disabled due to clashing with other plugins

- array-func/prefer-array-from
- import/order
- sort-imports

License

Copyright © 2019-21 David J. Bradshaw.
Licensed under the MIT License.