eslint-plugin-no-only-tests weekly downloads statistics

eslint-plugin-no-only-tests

ESLint rule for .only tests in Mocha, Jest, Jasmine, Mocha Cakes 2 and other JS testing libraries.

The following test blocks are matched by default: describe, it, context, tape, test, fixture, serial, Feature, Scenario, Given, And, When and Then.

Designed to prevent you from committing focused (.only) tests to CI, which may prevent your entire test suite from running.

If the testing framework you use doesn't use .only to focus tests, you can override the matchers with options.

Installation

Install ESLint if you haven't done so already, then install eslint-plugin-no-only-tests:

bun add --dev eslint eslint-plugin-no-only-tests

This package supports Node.js 5 or newer.

This repository uses Bun as its package manager.

If you're using Oxlint only, you do not need to install ESLint.

Usage

Flat Config (ESLint >= 9)

If you're using ESLint's flat config format, add the plugin to your eslint.config.js:

import noOnlyTests from "eslint-plugin-no-only-tests";

export default [
  {
    plugins: {
      "no-only-tests": noOnlyTests,
    },
    rules: {
      "no-only-tests/no-only-tests": "error",
    },
  },
];

Traditional Config (.eslintrc)

Add no-only-tests to the plugins section of your .eslintrc configuration file. You can omit the eslint-plugin- prefix:

"plugins": [
  "no-only-tests"
]

Then add the rule to the rules section of your .eslintrc:

"rules": {
  "no-only-tests/no-only-tests": "error"
}

Oxlint

Add eslint-plugin-no-only-tests to the jsPlugins section of your .oxlintrc.json.

"jsPlugins": ["eslint-plugin-no-only-tests"],

Then add the rule to the rules section of your .oxlintrc.json:

"rules": {
  "no-only-tests/no-only-tests": "error"
}

[!TIP] This package already works with Oxlint via jsPlugins. In v3.4.0, the rule was updated to use Oxlint's performance-focused createOnce API internally while keeping the same external configuration and ESLint compatibility.

Native test runner support

Some test runners can already fail focused tests at runtime:

• Mocha: --forbid-only
• Playwright Test: forbidOnly: !!process.env.CI
• Vitest: fails on .only in CI by default unless allowOnly is enabled

This plugin is still useful with those runners if you want editor feedback, ESLint-based CI, or opt-in autofixing.

Common framework setups

Jest

The default configuration works for describe.only, it.only and test.only:

"rules": {
  "no-only-tests/no-only-tests": "error"
}

Jest note: use this plugin when you want .only enforcement during linting, in editors, or in ESLint-based CI.

If your codebase also uses Jest's fit or fdescribe aliases, add them with functions:

"rules": {
  "no-only-tests/no-only-tests": ["error", { "functions": ["fit", "fdescribe"] }]
}

Vitest

The default configuration works for describe.only, it.only, test.only, and chained calls such as test.concurrent.only:

"rules": {
  "no-only-tests/no-only-tests": "error"
}

[!NOTE] Vitest already fails the run in CI when it encounters .only. The official allowOnly setting defaults to !process.env.CI, so focused tests fail by default in CI unless you opt back in.

Bun

If you use bun:test, the default configuration works for test.only and describe.only:

"rules": {
  "no-only-tests/no-only-tests": "error"
}

[!NOTE] Bun documents bun test --only as the switch that enables focused execution. Plain bun test still runs the full test suite, even when .only appears in the codebase.

Mocha

Mocha uses describe.only and it.only, so the default configuration works:

"rules": {
  "no-only-tests/no-only-tests": "error"
}

[!NOTE] Mocha has a native CI/runtime guard via --forbid-only, which fails the run if exclusive tests are present.

Cypress

Cypress uses Mocha-style describe.only and it.only, so the default configuration works:

"rules": {
  "no-only-tests/no-only-tests": "error"
}

Playwright Test

The default configuration works for test.only, test.describe.only, and similar chained APIs:

"rules": {
  "no-only-tests/no-only-tests": "error"
}

[!NOTE] Playwright has a native CI/runtime guard via forbidOnly.

Jasmine…