End-to-end tests

Setup with docker

Are you running everything through docker? You're so lucky you don't have to setup anything!

Just:

docker-compose up

Setup without docker

First, you have to tell cypress how to connect to your local neo4j database among other things. You can copy our template configuration and change the new file according to your needs.

Make sure you are at the root level of the project. Then:

# in the top level folder Human-Connection/
$ cp cypress.env.template.json cypress.env.json

To start the services that are required for cypress testing, run this:

# in the top level folder Human-Connection/
$ yarn cypress:setup

Install cypress

Even if the required services for testing run via docker, depending on your setup, the cypress tests themselves run on your host machine. So with our without docker, you would have to install cypress and its dependencies first:

# in the root folder /
yarn install

Run cypress

After verifying that there are no errors with the servers starting, open another tab in your terminal and run the following command:

$ yarn cypress:run
Console output after running cypress test

Open Interactive Test Console

If you are like me, you might want to see some visual output. The interactive cypress environment also helps at debugging your tests, you can even time travel between individual steps and see the exact state of the app.

To use this feature, instead of yarn cypress:run you would run the following command:

$ yarn cypress:open
Interactive Cypress Environment

Write some Tests

Check out the Cypress documentation for further information on how to write tests: https://docs.cypress.io/guides/getting-started/writing-your-first-test.html#Write-a-simple-test