eslint-plugin-jest-dom
ESLint plugin to follow best practices and anticipate common mistakes when writing tests with jest-dom.
Table of Contents
Installation
This module is distributed via npm which is bundled with node and
should be installed as one of your project's devDependencies
:
npm install --save-dev eslint-plugin-jest-dom
This library has a required peerDependencies
listing for ESLint
.
Usage
Add jest-dom
to the plugins section of your .eslintrc.js
configuration file.
You can omit the eslint-plugin-
prefix:
module.exports = {
plugins: ["jest-dom"],
rules: {
// your configuration
},
};
Then configure the rules you want to use under the rules section.
module.exports = {
rules: {
"jest-dom/prefer-checked": "error",
"jest-dom/prefer-enabled-disabled": "error",
"jest-dom/prefer-required": "error",
"jest-dom/prefer-to-have-attribute": "error",
},
};
Recommended Configuration
This plugin exports a recommended configuration that enforces good jest-dom
practices (you can find more info about enabled rules in
Supported Rules section).
To enable this configuration use the extends
property in your .eslintrc.js
config file:
module.exports = {
extends: "plugin:jest-dom/recommended",
rules: {
// your configuration
},
};
Supported Rules
๐ผ Configurations enabled in.
โ
Set in the recommended
configuration.
๐ง Automatically fixable by the --fix
CLI option.
๐ก Manually fixable by editor suggestions.
Nameย ย ย ย ย ย ย ย ย ย ย ย ย ย ย ย ย ย ย ย ย ย ย | Description | ๐ผ | ๐ง | ๐ก |
---|---|---|---|---|
prefer-checked | prefer toBeChecked over checking attributes | โ | ๐ง | |
prefer-empty | Prefer toBeEmpty over checking innerHTML | โ | ๐ง | |
prefer-enabled-disabled | prefer toBeDisabled or toBeEnabled over checking attributes | โ | ๐ง | |
prefer-focus | prefer toHaveFocus over checking document.activeElement | โ | ๐ง | |
prefer-in-document | Prefer .toBeInTheDocument() for asserting the existence of a DOM node | โ | ๐ง | ๐ก |
prefer-required | prefer toBeRequired over checking properties | โ | ๐ง | |
prefer-to-have-attribute | prefer toHaveAttribute over checking getAttribute/hasAttribute | โ | ๐ง | |
prefer-to-have-class | prefer toHaveClass over checking element className | โ | ๐ง | |
prefer-to-have-style | prefer toHaveStyle over checking element style | โ | ๐ง | |
prefer-to-have-text-content | Prefer toHaveTextContent over checking element.textContent | โ | ๐ง | |
prefer-to-have-value | prefer toHaveValue over checking element.value | โ | ๐ง |
Issues
Looking to contribute? Look for the Good First Issue label.
๐ Bugs
Please file an issue for bugs, missing documentation, or unexpected behavior.
๐ก Feature Requests
Please file an issue to suggest new features. Vote on feature requests by adding a ๐. This helps maintainers prioritize what to work on.
Contributors โจ
Thanks goes to these people (emoji key):
This project follows the all-contributors specification. Contributions of any kind welcome!
LICENSE
MIT