eslint-node-test weekly downloads statistics

eslint-node-test

ESLint rules for the Node.js built-in test runner (node:test)

This plugin helps you avoid common mistakes and write more consistent tests with node:test, the test runner built into Node.js.

Install

Requires ESLint >=10.4, flat config, and ESM.

Usage

Use a preset config or configure each rule in eslint.config.js.

Or configure rules individually:

The example scopes the plugin to JavaScript files. Add TypeScript extensions only when your ESLint config provides a TypeScript parser for them. The rules only activate in files that import from node:test (and assertion rules also activate for Node's built-in assert module), so you can safely apply the plugin across your whole project.

Rules

💼 Configurations enabled in.\ ✅ Set in the recommended configuration.\ ☑️ Set in the unopinionated configuration.\ 🔧 Automatically fixable by the --fix CLI option.\ 💡 Manually fixable by editor suggestions.

| Name | Description | 💼 | 🔧 | 💡 |

| assertion-arguments | Enforce the correct number of arguments for node:assert assertions. | ✅ ☑️ | | | | consistent-assert-style | Enforce a consistent truthiness assertion style. | ✅ | 🔧 | | | consistent-assert-throws-callback-style | Enforce a consistent body style for assert.throws() arrow callbacks. | | 🔧 | | | consistent-modifier-style | Enforce a consistent style for test modifiers. | | | | | consistent-test-context-name | Enforce a consistent name for the test context parameter. | ✅ ☑️ | | | | consistent-test-filename | Enforce a consistent test file name pattern. | | | | | consistent-test-it | Enforce consistent use of test or it. | | | | | hooks-order | Enforce a consistent order of hook declarations. | ✅ ☑️ | 🔧 | | | max-assertions | Enforce a maximum number of assertions in a test. | | | | | max-nested-describe | Enforce a maximum depth for nested describe blocks. | ✅ | | | | no-assert-in-describe | Disallow assertions directly inside a describe body. | ✅ | | | | no-assert-in-hook | Disallow assertions inside hooks. | | | | | no-assert-match-string | Disallow strings as the regexp argument of assert.match()/assert.doesNotMatch(). | ✅ ☑️ | | 💡 | | no-assert-throws-async | Disallow passing an async function to assert.throws()/assert.doesNotThrow(). | ✅ ☑️ | | 💡 | | no-assert-throws-call | Disallow calling the function passed to assert.throws(). | ✅ ☑️ | | 💡 | | no-assert-throws-multiple-statements | Disallow multiple statements in assert.throws()/assert.rejects() callbacks. | ✅ | | | | no-assert-throws-string | Disallow a string as the error matcher of assert.throws()/assert.rejects(). | ✅ ☑️ | | 💡 | | no-async-describe | Disallow async describe callbacks. | ✅ ☑️ | | | | no-async-fn-without-await | Disallow async test/hook functions that have no await expression. | ✅ ☑️ | | 💡 | | no-callback-and-promise | Disallow a test or hook from using both a callback and a Promise. | ✅ ☑️ | | | | no-commented-tests | Disallow commented-out tests. | | | | | no-compound-assertion | Disallow compound truthiness assertions. | ✅ ☑️ | 🔧 | | | no-conditional-assertion | Disallow assertions inside conditional code within a test. | ✅ ☑️ | | | | no-conditional-in-test | Disallow conditional logic inside tests. | | | | | no-conditional-tests | Disallow conditionally registering tests, suites, and hooks. | ✅ | | | | no-conflicting-modifiers | Disallow conflicting test modifiers. | ✅ ☑️ | | | | no-constant-assertion | Disallow assertions with constant outcomes. | ✅ ☑️ | | | | no-done-callback | Disallow callback (done) parameters in tests and hooks. | | | | | no-duplicate-assertions | Disallow adjacent duplicate assertions. | ✅ ☑️ | | | | no-duplicate-hooks | Disallow duplicate hooks within the same scope. | ✅ | | | | no-duplicate-mock-timers-enable | Disallow enabling mock timers more than once without resetting them. | ✅ ☑️ | | | | no-duplicate-plan | Disallow setting a test plan more than once in the same test. | ✅ ☑️ | | | | no-expect-failure-without-reason | Require a reason when marking a test or suite as expected to fail. | ✅ | | | | no-export | Disallow exports from test files. | ✅ | | | | no-identical-assertion-arguments | Disallow comparing a value to itself in an assertion. | ✅ ☑️ | | | | no-identical-title | Disallow identical test titles within the same scope. | ✅ ☑️ | | | | no-import-test-files | Disallow imports of Node.js test files. | ✅ ☑️ | | | | no-incorrect-deep-equal | Disallow deepEqual/deepStrictEqual (and their notDeep* variants) when comparing with primitives. | ✅ ☑️ | 🔧 | | | no-incorrect-strict-equal | Disallow strictEqual/equal (and their not* variants) when comparing with an object or array literal. | ✅ ☑️ | 🔧 | | | no-late-test-activity | Disallow test activity inside detached asynchronous callbacks. | ✅ ☑️ | 🔧 | | | no-loop-static-title | Disallow a static test or suite title inside a loop. | ✅ ☑️ | | | | no-misused-concurrency | Disallow the concurrency option on a test without subtests. | ✅ ☑️ | | | | no-misused-context-hook | Disallow context hooks without runnable subtests. | ✅ ☑️ | | | | no-mock-module-after-import | Disallow mocking a module after statically importing it. | ✅ ☑️ | | | | no-mock-timers-destructured-import | Disallow destructured timer imports when using mock.timers. | ✅ ☑️ | | | | no-nested-tests | Disallow tests and suites nested inside a test body. | ✅ ☑️ | | | | no-only-test | Disallow the .only test modifier. | ✅ ☑️ | | 💡 | | no-parent-test-context | Disallow references to parent test contexts inside subtests. | ✅ ☑️ | | 💡 | | no-process-chdir-in-test | Disallow changing the working directory inside tests. | ✅ | | | | no-process-env-mutation | Disallow mutating process.env inside tests. | ✅ | | | | no-process-exit-in-test | Disallow process exit control in test files. | ✅ ☑️ | | | | no-skip-test | Disallow the .skip test modifier. | ✅ | | 💡 | | no-skip-without-reason | Require a reason when skipping or marking a test as todo. | | | | | no-skip-without-return | Disallow…

Description from the npm listing.