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

npm install --save-dev eslint eslint-node-test

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

Usage

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

import nodeTest from 'eslint-node-test';
import {defineConfig} from 'eslint/config';

export default defineConfig([
	{
		files: [
			'**/*.js'
		],
		plugins: {
			'node-test': nodeTest
		},
		extends: [
			'node-test/recommended'
		]
	}
]);

Or configure rules individually:

import nodeTest from 'eslint-node-test';
import {defineConfig} from 'eslint/config';

export default defineConfig([
	{
		files: [
			'**/*.js'
		],
		plugins: {
			'node-test': nodeTest
		},
		rules: {
			'node-test/no-only-test': 'error',
			'node-test/no-identical-title': 'error'
		}
	}
]);

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

<!-- begin auto-generated rules list -->

💼 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().…