eslint-plugin-ui-testing

ESLint plugin that helps following best practices when writing UI tests. It supports the following automation tools (in alphabetical order):

• Cypress
• Playwright
• Puppeteer
• TestCafe
• WebdriverIO

Usage

Prerequisite:

• ESLint is installed (npm i eslint --save-dev)

1. Install eslint-plugin-ui-testing:

npm i eslint-plugin-ui-testing --save-dev

2. Add the ui-testing plugin to the .eslintrc configuration file.

{
    "plugins": ["ui-testing"]
}

3. Configure the rules as follows by using the recommended ruleset per automation tool. Choose one from:

• plugin:ui-testing/cypress
• plugin:ui-testing/playwright
• plugin:ui-testing/puppeteer
• plugin:ui-testing/testcafe
• plugin:ui-testing/webdriverio

Example:

{
    "extends": ["plugin:ui-testing/webdriverio"]
}

Customization

You can customize specific rules in the .eslintrc configuration file.

{
    "rules": {
        "ui-testing/no-disabled-tests": "error", // default = warn
        "ui-testing/no-css-page-layout-selector": ["warn", "webdriverio"] // default = error
    }
}

• In case you are using a recommended ruleset as described in step 3 (under Usage), then these customized rules will override the default.
• It is also possible to omit the recommended ruleset and just set each rule specifically as above.

Overview rules

Rule	Default	Ruleset
missing-assertion-in-test	error
no-absolute-url	warn
no-assertions-in-hooks	error
no-browser-commands-in-tests	warn
no-css-page-layout-selector	error
no-disabled-tests	warn
no-focused-tests	warn
no-hard-wait	error
no-implicit-wait	error
no-link-text-selector	error
no-tag-name-selector	error
no-wait-in-tests	warn
no-xpath-page-layout-selector	error
no-xpath-selector	warn

Note: All automation tool specific rulesets include the recommended ruleset.