Cypress won’t start

Can’t run because you’ve entered an invalid browser name

Can't run because you've entered an invalid browser name.

Browser: Replay Chromium was not found on your system or is not supported by Cypress.

Cypress supports the following browsers:
 - electron
 - chrome
 - chromium
 - chrome:canary
 - edge
 - firefox

You can also use a custom browser: <https://on.cypress.io/customize-browsers>

Available browsers found on your system are:
 - chrome
 - chromium
 - firefox
 - firefox:dev
 - firefox:nightly
 - electron
 - Replay Firefox

• This is expected (for now). Check first whether the process exits immediately, chances are the test ends up proceeding as expected!
• While modifying cypress.config.js, make sure you’re returning the config object in setupNodeEvents
• Make sure you’re using the correct browser for your operating system. replay-chromium is only supported on linux, whereas replay-firefox supports both mac and linux.
• The environment variable CYPRESS_INSTALL_BINARY may be suppressing the browser install step. If it’s set to 0, make sure to add an explicit workflow step to install the browsers (npx @replayio/cypress install)
• Your caching strategy might be keeping our plugin from pulling in the correct browser. Start debugging it by turning off all caching, e.g. actions/cache

How do I use Replay with versions earlier than 10.9?

Replay works best with Cypress 10.9 or later but can be used with Cypress 8 or later with some additional environment configuration:

• RECORD_ALL_CONTENT must be set when using replay-firefox to record replays
• RECORD_REPLAY_METADATA_FILE must be set for either browser to capture metadata about the test run.

When running locally, you can set these variables in your npm scripts so they are set every time:

"scripts": {
	"test:cypress": "cypress run",
  "test:cypress:replay": "RECORD_ALL_CONTENT=1 RECORD_REPLAY_METADATA_FILE=/tmp/replay-metadata cypress run"
}

On CI, you can set these environment variables on the task that runs your tests:

  # Install NPM dependencies, cache them correctly  
  # and run all Cypress tests
  - name: Cypress run
    uses: cypress-io/github-action@v5
			with:
				browser: replay-chromium
			env:
				RECORD_ALL_CONTENT: 1
				RECORD_REPLAY_METADATA_FILE: /tmp/replay-metadata

Replay browser runs but doesn’t record

The Replay browser is compiled against OpenSSL 1.1 which has been deprecated and is not included on some more recent platforms. To manually install it, run the following: