cypress-plugin-retries

cypress-plugin-retries beta

A Cypress plugin to retry failed tests

:warning: this module is in beta, and might cause some strange failures. Please report bugs in the issues of this repo.

Note: please refer to this issue for updates about official cypress retry support

Installation

Add the plugin to devDependencies

npm install -D cypress-plugin-retries

At the top of cypress/support/index.js:

require('cypress-plugin-retries')

Usage

[Preferred] On a per-test or per-hook basis, set the retry number:

Note: this plugin adds Cypress.currentTest and you should only use it if you're using this plugin.

Cypress.currentTest.retries(2)

or Use the environment variable CYPRESS_RETRIES to set the retry number for all spec files:

CYPRESS_RETRIES=2 npm run cypress

or Use Cypress.env('RETRIES') in your spec file to set the retry number for all tests:

Cypress.env('RETRIES', 2)

or [undersirable] Use mocha's this.retries(n) inside of a test:

Note: must use function() notation, not arrows ()=>{}

it('test', function() {
    this.retries(2)
})

License

MIT