Cypress e2e tests for o-platform

Requirements

For now these tests are written for the dev branch of o-platform in the land-local environment. To run these tests you need to have the land-local environment running.

Quickstart

# Clone the repo into the root of the circlesUBI project

git clone https://github.com/CirclesUBI/o-platform-cypress.git

cd o-platform-cypress

npm install

# Run all test-journeys in headless mode

./run.sh

# Run specific test-journey in headless mode

./run.sh -n FILENAME_WITHOUT_EXTENSION

# Run tests in cypress-browser

./run.sh -o

CLI Options

Running ./run.sh will run Cypress tests for o-platform. By default, it will run all tests in headless mode.

./run.sh

To run Cypress tests in headless mode, run the script with the -n option specify a test file without extensions (e.g. preSeededRegularUser).

./run.sh -n preSeededRegularUser

To run Cypress tests in browser mode, run the script with the -o option.

./run.sh -o

To see all options, run the script with the -h option.

./run.sh -h

Syntax: run.sh [-h|o|n] options: h Print this Help. o Opens cypress in browser-mode. n Run a specific test file in headless.

You can pass the following options to the run.sh script:

 h     Print Help.
 o     Opens cypress in browser-mode.
 n     Run a specific test file in headless.

Browsers

By default cypress runs in electron. However, these tests are written for chromium. To run in chromium, you need to install chromium on your system.

Start-Scripts

{
    "cy:open": "cp -f ../land-local/modes/from-source/.state/static-content/public/Person_1.y4m ./cypress/fixtures || exit && cypress open",
    "cy:run": "cp -f ../land-local/modes/from-source/.state/static-content/public/Person_1.y4m ./cypress/fixtures || exit && cypress run --browser chromium"
}

Cypress Video and Screenshots

Cypress will record a video of the test run and if a test fail take screenshots of the test run. These are stored in the cypress/videos and cypress/screenshots folders.