Home

Awesome

Actions Status npm version

<div align="center"> <!-- replace with accurate logo e.g from https://worldvectorlogo.com/ --> <img width="150" height="150" src="https://cdn.worldvectorlogo.com/logos/eslint.svg"> <a href="https://facebook.github.io/jest/"> <img width="150" height="150" vspace="" hspace="25" src="https://github.com/facebook/jest/blob/b5aa00204e80927efee6b44ac7dd6b22b8c78e22/website/static/img/jest.png"> </a> <h1>jest-runner-eslint</h1> <p>ESLint runner for Jest</p> </div> <div align="center"> <img src="https://user-images.githubusercontent.com/574806/30197438-9681385c-941c-11e7-80a8-2b11f15bd412.gif"> </div>

Usage

Install

Install jest(it needs Jest 21+) and jest-runner-eslint

yarn add --dev jest jest-runner-eslint

# or with NPM

npm install --save-dev jest jest-runner-eslint

Add it to your Jest config

Standalone

In your package.json

{
  "jest": {
    "runner": "jest-runner-eslint",
    "displayName": "lint",
    "testMatch": ["<rootDir>/src/**/*.js"]
  }
}

Or in jest.config.js

module.exports = {
  runner: 'jest-runner-eslint',
  displayName: 'lint',
  testMatch: ['<rootDir>/src/**/*.js'],
};

Please update testMatch to match your project folder structure

Alongside other runners

It is recommended to use the projects configuration option to run multiple Jest runners simultaneously.

If you are using Jest <22.0.5, you can use multiple Jest configuration files and supply the paths to those files in the projects option. For example:

// jest-test.config.js
module.exports = {
  // your Jest test options
  displayName: 'test',
};

// jest-eslint.config.js
module.exports = {
  // your jest-runner-eslint options
  runner: 'jest-runner-eslint',
  displayName: 'lint',
  testMatch: ['<rootDir>/src/**/*.js'],
};

In your package.json:

{
  "jest": {
    "projects": [
      "<rootDir>/jest-test.config.js",
      "<rootDir>/jest-eslint.config.js"
    ]
  }
}

Or in jest.config.js:

module.exports = {
  projects: [
    '<rootDir>/jest-test.config.js',
    '<rootDir>/jest-eslint.config.js',
  ],
};

If you are using Jest >=22.0.5, you can supply an array of project configuration objects instead. In your package.json:

{
  "jest": {
    "projects": [
      {
        "displayName": "test"
      },
      {
        "runner": "jest-runner-eslint",
        "displayName": "lint",
        "testMatch": ["<rootDir>/src/**/*.js"]
      }
    ]
  }
}

Or in jest.config.js:

module.exports = {
  projects: [
    {
      displayName: 'test',
    },
    {
      runner: 'jest-runner-eslint',
      displayName: 'lint',
      testMatch: ['<rootDir>/src/**/*.js'],
    },
  ],
};

Run Jest

yarn jest

Toggle --fix in watch mode

jest-runner-eslint comes with a watch plugin that allows you to toggle the --fix value while in watch mode without having to update your configuration.

fix

To use this watch plugin simply add this to your Jest configuration.

{
  watchPlugins: ['jest-runner-eslint/watch-fix'],
}

After this run Jest in watch mode and you will see the following line in your watch usage menu

 › Press F to override ESLint --fix.

Options

This project uses cosmiconfig, so you can provide config via:

In package.json

{
  "jest-runner-eslint": {
    "cliOptions": {
      // Options here
    }
  }
}

or in jest-runner-eslint.config.js

module.exports = {
  cliOptions: {
    // Options here
  },
};

cliOptions

jest-runner-eslint maps a lot of ESLint CLI arguments to config options. For example --fix is cliOptions.fix

optiondefaultexample
cachefalse"cache": true
cacheLocation.eslintcache"cacheLocation": "/path/to/cache"
confignull"config": "/path/to/config"
envnull"env": "mocha" or "env": ["mocha", "other"]
ext[".js"]"ext": ".jsx" or "ext": [".jsx", ".ts"]
fixfalse"fix": true
fixDryRunfalse"fixDryRun": true
formatnull"format": "codeframe"
global[]"global": "it" or "global": ["it", "describe"]
ignorePathnull"ignorePath": "/path/to/ignore"
ignorePattern[]"ignorePattern": ["/path/to/ignore/*"]
maxWarnings-1"maxWarnings": 0
noEslintrcfalse"noEslintrc": true
noIgnorefalse"noIgnore": true
noInlineConfigfalse"noInlineConfig": true
parserespree"parser": "flow"
parserOptions{}"parserOptions": { "myOption": true }
plugin[]"plugin": "prettier" or "plugin": ["prettier", "other"]
quietfalse"quiet": true
resolvePluginsRelativeToundefined"resolvePluginsRelativeTo": "./eslint-config"
reportUnusedDisableDirectivesfalse"reportUnusedDisableDirectives": true
rules{}"rules": {"quotes": [2, "double"]} or "rules": {"quotes": [2, "double"], "no-console": 2}
rulesdir[]"rulesdir": "/path/to/rules/dir" or "rulesdir": ["/path/to/rules/dir", "/path/to/other"]