jest.md

@code-pushup/eslint-config/jest config

Config for projects using Jest for testing.

🏗️ Setup

1. If you haven't already, make sure to install @code-pushup/eslint-config and its required peer dependencies.

2. Since this plugin requires additional peer dependencies, you have to install them as well:

   npm install -D eslint-plugin-jest

3. Add to extends in your .eslintrc file:

   {
     "extends": ["@code-pushup/eslint-config/jest"],
     // customize rules if needed:
     "rules": {
       // e.g. to customize `test` or `it` usage (default is `it` in `describe` and `test` at top-level):
       "jest/consistent-test-it": ["warn", { "fn": "test", "withinDescribe": "test" }]
     }
   }

📏 Rules (37)

🔧 Automatically fixable by the --fix CLI option.
💡 Manually fixable by editor suggestions.

🚨 Errors (8)

Plugin	Rule	Options	Autofix
	no-identical-title Disallow identical titles
	no-interpolation-in-snapshots Disallow string interpolation inside snapshots
	no-jasmine-globals Disallow Jasmine globals		🔧
	no-test-prefixes Require using .only and .skip over f and x		🔧
	valid-describe-callback Enforce valid describe() callback
	valid-expect Enforce valid expect() usage		🔧
	valid-expect-in-promise Require promises that have expectations in their chain to be valid
	valid-title Enforce valid titles		🔧

⚠️ Warnings (29)

Plugin	Rule	Options	Autofix
	consistent-test-it Enforce test and it usage conventions		🔧
	expect-expect Enforce assertion to be made in a test body
	max-nested-describe Enforces a maximum depth to nested describe calls	max: 2 { "max": 2 }
	no-alias-methods Disallow alias methods		🔧
	no-commented-out-tests Disallow commented out tests
	no-conditional-expect Disallow calling expect conditionally
	no-deprecated-functions Disallow use of deprecated functions		🔧
	no-disabled-tests Disallow disabled tests
	no-done-callback Disallow using a callback in asynchronous tests and hooks		💡
	no-duplicate-hooks Disallow duplicate setup and teardown hooks
	no-export Disallow using exports in files containing tests
	no-focused-tests Disallow focused tests		💡
	no-mocks-import Disallow manually importing from __mocks__
	no-standalone-expect Disallow using expect outside of it or test blocks
	no-test-return-statement Disallow explicitly returning from tests
	prefer-comparison-matcher Suggest using the built-in comparison matchers		🔧
	prefer-each Prefer using .each rather than manual loops
	prefer-equality-matcher Suggest using the built-in equality matchers		💡
	prefer-expect-resolves Prefer await expect(...).resolves over expect(await ...) syntax		🔧
	prefer-hooks-on-top Suggest having hooks before any test cases
	prefer-mock-promise-shorthand Prefer mock resolved/rejected shorthands for promises		🔧
	prefer-spy-on Suggest using jest.spyOn()		🔧
	prefer-to-be Suggest using toBe() for primitive literals		🔧
	prefer-to-contain Suggest using toContain()		🔧
	prefer-to-have-length Suggest using toHaveLength()		🔧
	prefer-todo Suggest using test.todo		🔧
	require-hook Require setup and teardown code to be within a hook
	require-to-throw-message Require a message for toThrow()
	require-top-level-describe Require test cases and hooks to be inside a describe block