298

Is there a way to disable specific rules for a folder? For example, I don't want to have required JSDoc comments for all my test files in the test folder. Is there a way to do this?

1
  • 1
    eslint-babel seems to ignore any .eslint-ignore files and settings. May 1, 2018 at 4:14

4 Answers 4

458

To ignore some folder from eslint rules we could create the file .eslintignore in root directory and add there the path to the folder we want omit (the same way as for .gitignore).

Here is the example from the ESLint docs on Ignoring Files and Directories:

# path/to/project/root/.eslintignore
# /node_modules/* and /bower_components/* in the project root are ignored by default

# Ignore built files except build/index.js
build/*
!build/index.js
7
  • 90
    This solution doesn't really answer the original question, which asks how to disable specific rules for a particular directory. Here you're disabling all rules for the given directories. Better answer is here: stackoverflow.com/a/41316801/882638
    – ericgio
    Apr 10, 2018 at 22:50
  • 5
    Excerpt from the ESLint documentation "In addition to any patterns in a .eslintignore file, ESLint always ignores files in /node_modules/* and /bower_components/*." So there's no need to add /node_modules, /dist alone is enough to exclude the both of the directories. Also glob pattern is supported whilst specifying (sub)directories.
    – ozanmuyes
    Aug 2, 2018 at 12:43
  • 5
    Is there anyway of configuring which directories to ignore in the .eslintrc.json configuration file itself so we don't need yet another .estlint file and we can inherit ignore values from an eslint-config-myconfig shared configuration? Mar 13, 2019 at 17:39
  • 1
    There are multiple similar posts on this. I needed: --ignore-path and/or --ignore-pattern, and I think that also accurately answers this question. Jul 5, 2019 at 17:02
  • 3
    To answer my own comment from a year ago, as of ESLint 6.7.0+, you can now use a top-level attribute ignorePatterns to provide an Array of patterns to ignore. Read the release announcement here: eslint.org/blog/2019/11/eslint-v6.7.0-released May 11, 2020 at 3:48
130

The previous answers were in the right track, but the complete answer for this is going to be about disabling rules only for a group of files, there you'll find the documentation needed to disable/enable rules for certain folders (Because in some cases you don't want to ignore the whole thing, only disable certain rules). Example:

    {
        "env": {},
        "extends": [],
        "parser": "",
        "plugins": [],
        "rules": {},
        "overrides": [
          {
            "files": ["test/*.spec.js"], // Or *.test.js
            "rules": {
              "require-jsdoc": "off"
            }
          }
        ],
        "settings": {}
    }
4
  • 9
    This answer is better because you can turn off a specific rule for a given directory. Instead of just turning off all rules for a directory. Sep 10, 2019 at 10:38
  • 5
    This initially didn’t work for me. Make sure you don’t have a .eslintrc.js in that folder with an extends: "../.eslintrc.js"! Feb 23, 2020 at 17:09
  • 4
    In this method, is there any solution to turn off all eslint for the folder?
    – Anand
    Feb 10, 2021 at 11:58
  • 3
    This is the actual answer I was looking for in my search.
    – x1a4
    Sep 28, 2021 at 0:56
45

In ESLint 6.7.0+ use "ignorePatterns": [].

You can tell ESLint to ignore specific files and directories using ignorePatterns in your config files.

example of .eslintrc.js

    module.exports = {
  env: {
   ...
  },
  extends: [
   ...
  ],
  parserOptions: {
  ...
  },
  plugins: [
   ...
  ],
  rules: {
   ...
  },
  ignorePatterns: ['src/test/*'], // <<< ignore all files in test folder
};

Or you can ignore files with some extension:

ignorePatterns: ['**/*.js']

You can read the user-guide doc here.

https://eslint.org/docs/user-guide/configuring/ignoring-code

1
  • 1
    And notice that don't start your path with ./src/foo/bar. Use src/foo/bar instead.
    – Kindred
    May 3, 2022 at 1:53
3

YAML version :

overrides:
  - files: *-tests.js
    rules:
      no-param-reassign: 0

Example of specific rules for mocha tests :

You can also set a specific env for a folder, like this :

overrides:
  - files: test/*-tests.js
    env:
      mocha: true

This configuration will fix error message about describe and it not defined, only for your test folder:

/myproject/test/init-tests.js
6:1 error 'describe' is not defined no-undef
9:3 error 'it' is not defined no-undef

Not the answer you're looking for? Browse other questions tagged or ask your own question.