Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/maks-rafalko/eslint-plugin-proper-tests
ESLint rules for writing more proper tests.
https://github.com/maks-rafalko/eslint-plugin-proper-tests
eslint eslint-plugin eslintplugin jest rules
Last synced: 6 days ago
JSON representation
ESLint rules for writing more proper tests.
- Host: GitHub
- URL: https://github.com/maks-rafalko/eslint-plugin-proper-tests
- Owner: maks-rafalko
- License: bsd-3-clause
- Created: 2024-06-30T21:44:22.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2024-07-14T12:26:44.000Z (3 months ago)
- Last Synced: 2024-09-25T00:05:31.527Z (9 days ago)
- Topics: eslint, eslint-plugin, eslintplugin, jest, rules
- Language: TypeScript
- Homepage: https://www.npmjs.com/package/eslint-plugin-proper-tests
- Size: 38.1 KB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
eslint-plugin-proper-tests
ESLint plugin for writing proper tests
## Installation
```bash
npm install -D eslint-plugin-proper-tests
```
## Usage
Add `proper-tests` to the plugins section of your `.eslintrc` configuration file. You
can omit the `eslint-plugin-` prefix:
```js
module.exports = {
"plugins": ["proper-tests"]
}
```
And then use the `recommended` shared configuration:
```js
module.exports = {
"extends": ["plugin:proper-tests/recommended"]
}
```
Or configure the rules one by one (not recommended):
```js
module.exports = {
"rules": {
"proper-tests/no-useless-matcher-to-be-defined": "error"
}
}
```
This plugin uses TypeScript to provide more accurate results. To enable this, you need to [configure ESLint to work with TypeScript](https://typescript-eslint.io/getting-started/typed-linting):
```js
module.exports = {
"parser": "@typescript-eslint/parser",
"parserOptions": {
"project": true,
"tsconfigRootDir": __dirname,
}
}
```
### Running rules only on test-related files
The rules provided by this plugin assume that the files they are checking are
test-related. This means it's generally not suitable to include them in your
top-level configuration as that applies to all files being linted which can
include source files.
For `.eslintrc` configs you can use
[overrides](https://eslint.org/docs/user-guide/configuring/configuration-files#how-do-overrides-work)
to have ESLint apply additional rules to specific files:
```js
module.exports = {
"extends": ["eslint:recommended"],
"overrides": [
{
"files": ["test/**"],
"plugins": ["proper-tests"],
"extends": ["plugin:proper-tests/recommended"],
"rules": { "proper-tests/no-useless-matcher-to-be-defined": "off" }
}
],
"rules": {
"indent": ["error", 2]
}
}
```
## Shareable configurations
### Recommended
This plugin exports a recommended configuration that enforces good testing
practices.
To enable this configuration with `.eslintrc`, use the `extends` property:
```json
{
"extends": ["plugin:proper-tests/recommended"]
}
```
## Rules
💼 Configurations enabled in.\
✅ Set in the `recommended` configuration.
| Name                            | Description | 💼 |
| :--------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------- | :- |
| [no-long-arrays-in-test-each](docs/rules/no-long-arrays-in-test-each.md) | Disallow using long arrays with objects inside `test.each()` or `it.each()`. Force moving them out of the file. | ✅ |
| [no-mixed-expectation-groups](docs/rules/no-mixed-expectation-groups.md) | Disallow mixing expectations for different variables between each other. | ✅ |
| [no-useless-matcher-to-be-defined](docs/rules/no-useless-matcher-to-be-defined.md) | Disallow using `.toBeDefined()` matcher when it is known that variable is always defined. | ✅ |
| [no-useless-matcher-to-be-null](docs/rules/no-useless-matcher-to-be-null.md) | Disallow using `.toBeNull()` when TypeScript types conflict with it. | ✅ |
In order to use the rules powered by TypeScript type-checking, you must be using
`@typescript-eslint/parser` & adjust your eslint config as outlined
[here](https://typescript-eslint.io/getting-started/typed-linting/).
## Related Projects
### eslint-plugin-jest
The main plugin to be installed when Jest is used.
### eslint-plugin-jest-formatting
This project aims to provide formatting rules (auto-fixable where possible) to
ensure consistency and readability in jest test suites.