cypress-repeat [![ci status][ci image]][ci url] [![renovate-app badge][renovate-badge]][renovate-app] !cypress version

> Run Cypress multiple times in a row, great at finding test flake

Read Wrap Cypress Using NPM Module API and Retry, Rerun, Repeat.

Install

``shell
npm i -D cypress-repeat


or using Yarn


yarn add -D cypress-repeat
`

This module assumes the cypress dependency v5.3.0+ has been installed.

Use

`shell
npx cypress-repeat run -n ... rest of "cypress run" arguments
`

Which will run Cypresss times, exiting after the first failed run or after all runs finish successfully.

$3

You can flip the logic and run Cypress up to N times until the first successful exit

`shell
npx cypress-repeat run -n --until-passes ... rest of "cypress run" arguments
`


$3

You can rerun only the specs that failed

`shell
npx cypress-repeat run -n --until-passes --rerun-failed-only ... rest of "cypress run" arguments
`

$3

Every run has two utility variables injected

`js
const n = Cypress.env('cypress_repeat_n') // total repeat attempts
const k = Cypress.env('cypress_repeat_k') // current attempt, starts with 1
// and is <= n
`

Debugging

Run this script with environment variable DEBUG=cypress-repeat` to see verbose logs

What about test retries?

This NPM module retries the entire Cypress run, if you need to retry just the failed tests, use the Test Retries.

[ci image]: https://github.com/bahmutov/cypress-repeat/workflows/ci/badge.svg?branch=main
[ci url]: https://github.com/bahmutov/cypress-repeat/actions
[renovate-badge]: https://img.shields.io/badge/renovate-app-blue.svg
[renovate-app]: https://renovateapp.com/