eslint-plugin-ava

What is eslint-plugin-ava?

eslint-plugin-ava is an ESLint plugin that provides linting rules specific to the AVA test runner. It helps ensure best practices and consistency when writing tests with AVA.

What are eslint-plugin-ava's main functionalities?

Ensure test file naming conventions

This rule enforces a specific naming pattern for test files, ensuring that all test files follow a consistent naming convention.

module.exports = { "rules": { "ava/test-file-name": ["error", { "pattern": "test-*.js" }] } };

Disallow use of t.pass() and t.fail()

This rule disallows the use of t.pass() and t.fail() in tests, encouraging more meaningful assertions.

module.exports = { "rules": { "ava/no-t-pass-fail": "error" } };

Ensure correct use of t.plan()

This rule ensures that t.plan() is used correctly, helping to avoid common mistakes when planning assertions in tests.

module.exports = { "rules": { "ava/use-t-well": "error" } };

Disallow use of assertions outside of tests

This rule disallows the use of assertions outside of test functions, ensuring that all assertions are made within the context of a test.

module.exports = { "rules": { "ava/no-assertion-outside-test": "error" } };

Other packages similar to eslint-plugin-ava

eslint-plugin-jest

eslint-plugin-jest provides linting rules specific to the Jest test runner. It offers similar functionality to eslint-plugin-ava but is tailored for Jest, ensuring best practices and consistency when writing tests with Jest.

eslint-plugin-mocha

eslint-plugin-mocha provides linting rules specific to the Mocha test framework. Like eslint-plugin-ava, it helps enforce best practices and consistency, but it is designed for use with Mocha.

eslint-plugin-jasmine

eslint-plugin-jasmine offers linting rules for the Jasmine testing framework. It serves a similar purpose to eslint-plugin-ava but is focused on ensuring best practices and consistency in Jasmine tests.

README

eslint-plugin-ava

ESLint rules for AVA

Install

$ npm install --save-dev eslint eslint-plugin-ava

Usage

Configure it in package.json.

{
	"name": "my-awesome-project",
	"eslintConfig": {
		"env": {
			"es6": true
		},
		"parserOptions": {
			"ecmaVersion": 6,
			"sourceType": "module"
		},
		"plugins": [
			"ava"
		],
		"rules": {
			"ava/max-asserts": [2, 5],
			"ava/no-cb-test": 0,
			"ava/no-identical-title": 2,
			"ava/no-invalid-end": 2,
			"ava/no-only-test": 2,
			"ava/no-skip-assert": 2,
			"ava/no-skip-test": 2,
			"ava/no-statement-after-end": 2,
			"ava/no-todo-test": 1,
			"ava/no-unknown-modifiers": 2,
			"ava/prefer-power-assert": 0,
			"ava/test-ended": 2,
			"ava/test-title": [2, "always"],
			"ava/use-t": 2,
			"ava/use-test": 2
		}
	}
}

Rules

The rules will only activate in test files.

• max-asserts - Limit the number of assertions in a test.
• no-cb-test - Ensure no test.cb() is used.
• no-identical-title - Ensure no tests have the same title.
• no-invalid-end - Ensure t.end() is only called inside test.cb().
• no-only-test - Ensure no test.only() are present.
• no-skip-assert - Ensure no assertions are skipped.
• no-skip-test - Ensure no tests are skipped.
• no-statement-after-end - Ensure t.end() is the last statement executed.
• no-todo-test - Ensure no test.todo() is used.
• no-unknown-modifiers - Prevent the use of unknown test modifiers.
• prefer-power-assert - Allow only use of the asserts that have no power-assert alternative.
• test-ended - Ensure callback tests are explicitly ended.
• test-title - Ensure tests have a title.
• use-t - Ensure test functions use t as their parameter.
• use-test - Ensure that AVA is imported with test as the variable name.

Recommended configuration

This plugin exports a recommended configuration that enforces good practices.

To enable this configuration use the extends property in your package.json.

{
	"name": "my-awesome-project",
	"eslintConfig": {
		"extends": "plugin:ava/recommended",
		"plugins": [
			"ava"
		]
	}
}

See ESLint documentation for more information about extending configuration files.

Note: This configuration will also enable the correct parser options and environment.

Credit

• Jeroen Engels
• Takuto Wada
• And our awesome contributors

License

MIT © Sindre Sorhus