Even though you can get far with vanilla ESLint, there are certain techniques you should know. For instance, sometimes you want to skip specific rules per file. You can even implement rules of your own.
One of the most convenient ways to speed up ESLint execution on big projects is to run it on only files that have been changed while you are working. It’s possible to achieve this by using lint-staged. The exact technique is covered in the Automation chapter.
Node comes with startup overhead and it takes a while for the processing to begin. eslint_d is a daemon process designed to overcome this problem. It runs ESLint as a process in the background. esprint is a similar approach. It runs ESLint across multiple threads parallel.
You can find [more technical details about esprint in its introduction post](https://medium.com/@Pinterest_Engineering/introducing-esprint-a-fast-open-source-eslint-cli-19a470cd1c7d).
ESLint allows you to skip rules on several levels. Consider the following examples:
// everything
/* eslint-disable */
// ...
/* eslint-enable */
// specific rule
/* eslint-disable no-unused-vars */
// ...
/* eslint-enable no-unused-vars */
// tweaking a rule
/* eslint no-comma-dangle:1 */
// disable rule per line
alert('foo'); // eslint-disable-line no-alert
The rule specific examples assume you have the rules in your configuration in the first place! You cannot specify new rules here. Instead, you can modify the behavior of existing rules.
Sometimes, you want to run ESLint in a specific environment, such as Node or Mocha. These environments have certain conventions of their own. For instance, Mocha relies on custom keywords (e.g., describe, it) and it’s good if the linter doesn’t choke on those.
ESLint provides two ways to deal with this: local and global. To set it per file, you can use a declaration at the beginning of a file:
/*eslint-env node, mocha */
Global configuration is possible as well. In this case, you can use env key:
.eslintrc.json
{
"env": {
"browser": true,
"commonjs": true,
"es6": true,
"node": true
}
// ...
}
ESLint plugins rely on Abstract Syntax Tree (AST) definition of JavaScript. It’s a data structure that describes JavaScript code after it has been lexically analyzed. There are tools, such as recast, that allow you to perform transformations on JavaScript code by using AST transformations. The idea is that you match a structure, then transform it somehow and convert AST back to JavaScript.
To get a better idea of how AST works and what it looks like, you can check Esprima online JavaScript AST visualization or AST Explorer by Felix Kling. Alternately, you can install recast and examine the output it gives. You work with the structure for ESLint rules.
[Codemod](https://github.com/facebook/codemod) allows you to perform large-scale changes to your codebase through AST based transformations.
In ESLint’s case, the AST structure can be checked. If something is wrong, it should let you know. Follow the steps below to set up a plugin:
eslint-plugin-custom. You can replace custom with something else. ESLint follows this naming convention.npm init -y to create a dummy package.jsonindex.js in the project root with content.You can get started with a skeleton as below:
eslint-plugin-custom/index.js
module.exports = {
rules: {
demo: {
docs: {
description: 'Demo rule',
category: 'Best Practices',
recommended: true,
},
schema: [
{
type: 'object',
// JSON Schema to describe properties
properties: {},
additionalProperties: false,
},
],
create(context) {
return {
Identifier(node) {
context.report(node, 'This is unexpected!');
},
};
},
},
},
};
In this case, you report for every identifier found. In practice, you likely want to do something more complex than this, but this is a good starting point.
Next, you need to execute npm link within eslint-plugin-custom to make your plugin visible to your system. npm link allows you to consume a development version of a library you are developing. To reverse the link, you can execute npm unlink when you feel like it.
You need to alter the project configuration to make it find the plugin and the rule within.
.eslintrc.json
{
// ...
"plugins": [
// ...
"custom"
],
"rules": {
// ...
"custom/demo": 1,
}
}
If you invoke ESLint now, you should see a bunch of warnings. Of course, the rule doesn’t do anything impressive yet. To move forward, check out the official plugin documentation and rules.
You can also check out the existing rules and plugins for inspiration to see how they achieve certain things. ESLint allows you to extend these rulesets through extends property. It accepts either a path to it ("extends": "./node_modules/coding-standard/.eslintrc.json") or an array of paths. The entries are applied in the given order, and later ones override the former.
Besides the official documentation available at eslint.org, you should check out the following blog posts:
If you want a starting point, you can pick one of eslint-config- packages or go with the standard style.
You can customize ESLint to various purposes. Thanks to its vibrant ecosystem, it’s likely you find rules that are close to your purposes. Those make excellent starting points for your own development.
To recap:
This book is available through Leanpub. By purchasing the book you support the development of further content.