Our browser tests are based on Cypress. To get an overview of Cypress, we recommend going through their very extensive and well-written guides, especially Writing your first test and Introduction to Cypress.
The tests are automatically run by the CI environment.
To run them locally, you can use the Cypress test runner. Make sure you have the correct dependencies installed by running: yarn cypress verify
If you want to, you can override the launch URLs:
export CYPRESS_baseUrl='http://localhost:1314'Then, run yarn cypress open to open the test runner. As we are running Electron in the CI env, you should also select that as the browser for local testing to get consistent results.
To run tests against the production site, you need to make sure to set the correct base URL and environment:
export CYPRESS_baseUrl='https://www.datarequests.org'
export CYPRESS_baseUrl_DE='https://www.datenanfragen.de'
export CYPRESS_ENVIRONMENT=productionIf you are writing a test that doesn't work in production, you can then use skipOn(isOn('production')) to skip it for production tests after importing import { isOn, skipOn } from '@cypress/skip-test'. See the @cypress/skip-test README for more details.
TODO: Change to skipOn('production') once the plugin actually behaves as documented, see: cypress-io/cypress-skip-test#41