npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

jest-runner-eslint

v2.2.1

Published

An ESLint runner for Jest

Downloads

384,897

Readme

Actions Status npm version

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:

  • a jest-runner-eslint property in your package.json
  • a jest-runner-eslint.config.js JS file
  • a .jest-runner-eslintrc JSON file

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

| option | default | example | | ----------------------------- | -------------- | --------------------------------------------------------------------------------------------- | | cache | false | "cache": true | | cacheLocation | .eslintcache | "cacheLocation": "/path/to/cache" | | config | null | "config": "/path/to/config" | | env | null | "env": "mocha" or "env": ["mocha", "other"] | | ext | [".js"] | "ext": ".jsx" or "ext": [".jsx", ".ts"] | | fix | false | "fix": true | | fixDryRun | false | "fixDryRun": true | | format | null | "format": "codeframe" | | global | [] | "global": "it" or "global": ["it", "describe"] | | ignorePath | null | "ignorePath": "/path/to/ignore" | | ignorePattern | [] | "ignorePattern": ["/path/to/ignore/*"] | | maxWarnings | -1 | "maxWarnings": 0 | | noEslintrc | false | "noEslintrc": true | | noIgnore | false | "noIgnore": true | | noInlineConfig | false | "noInlineConfig": true | | parser | espree | "parser": "flow" | | parserOptions | {} | "parserOptions": { "myOption": true } | | plugin | [] | "plugin": "prettier" or "plugin": ["prettier", "other"] | | quiet | false | "quiet": true | | resolvePluginsRelativeTo | undefined | "resolvePluginsRelativeTo": "./eslint-config" | | reportUnusedDisableDirectives | false | "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"] |