Frontend testing

We have a mixture of typescript in the main website's code (located in static/tests) and Cypress (located in cypress/integration) to test and report on the workings of that code.

But there's always the possibility to use Cypress code to do UI checks and testing.

Recommended

The recommended way of testing is to use typescript to test the inner workings of the various interfaces that are available.

This has the advantage of having types and being able to verify your code is consistent with the rest of the website and probably going to run correctly - without having to startup the website and Cypress.

Adding a test

Steps to add a test:

• Create a new file in static/tests (copy paste from static/tests/hello-world.ts)
• Make sure to change the description as well as the test
• Add the file to the imports of static/tests/_all.js
• Add a runFrontendTest() call with the new test description to cypress/integration/frontend-testing.js

Starting tests locally

You don't need to install an entire X server to actually run cypress (just xfvb).

You can find a complete list at https://docs.cypress.io/guides/getting-started/installing-cypress#System-requirements

If you have the prerequisites installed, you should be able to run npx cypress run - however, you will need to start the CE website separately in another terminal before that.