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 🙏

© 2026 – Pkg Stats / Ryan Hefner

eslint-plugin-jest-formatting

v4.0.0

Published

ESLint rules for formatting jest tests

Readme

CI npm monthly downloads

eslint-plugin-jest-formatting

This package provides ESLint rules for jest test suites.

This project aims to provide formatting rules (auto-fixable where possible) to ensure consistency and readability in jest test suites.

Like this plugin? Say thanks with a ⭐️

Note: The master version may not be the version deployed to npm. Please treat https://www.npmjs.com/package/eslint-plugin-jest-formatting as the cannonical source for docs.

Installation

Requires Node 22 or later and ESLint 8, 9, or 10. There is no Jest version requirement: the rules match identifiers such as describe and expect and import nothing from Jest.

You'll first need to install ESLint:

$ yarn add eslint --dev

Next, install eslint-plugin-jest-formatting:

$ yarn add eslint-plugin-jest-formatting --dev

Note: If you installed ESLint globally (using the -g flag) then you must also install eslint-plugin-jest-formatting globally.

Usage

Flat config (ESLint 9+, eslint.config.js)

import jestFormatting from 'eslint-plugin-jest-formatting';

export default [
  // ...your other config objects
  jestFormatting.configs['flat/recommended'],
];

flat/strict enables every rule via padding-around-all. The flat configs do not set files, so the rules run on every file ESLint already lints. To scope them to test files, spread the config into your own object (name the extensions explicitly: in flat config a files glob opts matching files into linting, and a bare **/*.test.* would also match Jest snapshot files). These patterns cover the same file names as the legacy presets:

export default [
  {
    files: [
      '**/*{.test,_test,Test,.spec,_spec,Spec}.{js,jsx,mjs,cjs,mts,cts,ts,tsx}',
      '**/__tests__/**/*.{js,jsx,mjs,cjs,mts,cts,ts,tsx}',
    ],
    ...jestFormatting.configs['flat/recommended'],
  },
];

With CommonJS use const jestFormatting = require('eslint-plugin-jest-formatting');.

Legacy config (.eslintrc)

For ESLint 8 and 9 only: ESLint 10 no longer reads .eslintrc, and ESLint 9 needs ESLINT_USE_FLAT_CONFIG=false to read it.

Add jest-formatting to the plugins section of your .eslintrc configuration file. You can omit the eslint-plugin- prefix:

{
  "plugins": ["jest-formatting"]
}

Then configure the rules you want to use under the rules section.

{
  "rules": {
    "jest-formatting/padding-around-describe-blocks": 2,
    "jest-formatting/padding-around-test-blocks": 2
  }
}

or

You can use our "recommended" settings which enables most of the rules for you

{
  "extends": ["plugin:jest-formatting/recommended"]
}

We also support a "strict" settings which enabled all of the rules for you

{
  "extends": ["plugin:jest-formatting/strict"]
}

Rule Documentation

Using with AI coding agents

This plugin is built to be driven by coding agents as well as people:

  • Self-describing messages. Every report says what is missing, where, and how to fix it, for example: Missing blank line before `describe`. Expected at least one blank line between the previous statement and this `describe` call. Fix: insert an empty line between the statements, before any comments leading the next statement (autofixable with --fix). An agent can act on the message without opening the docs.
  • Everything is autofixable. eslint --fix resolves every report from this plugin by inserting blank lines. The fixer never removes or reorders code.
  • Fixed documentation shape. Each page in docs/rules has the same sections in the same order: Rule summary, Why, Incorrect examples, Correct examples, Options, Fixability. Each rule's meta.docs.url points at its page.
  • AGENTS.md is a one-page briefing: what the plugin does, every rule in one line, flat and legacy config snippets, and how to build and test.
  • llms.txt lists the documentation in the llms.txt format for tools that fetch context automatically.

Related Projects

eslint-plugin-jest

This provides an extensive set of jest eslint rules

https://github.com/jest-community/eslint-plugin-jest