To set up our Cypress E2E test environment use the AppBuilder Installer to setup a development environment. Note the additional steps for testing section.
Scripts
Use npm test to start the docker test stack and run the tests in a headless browser. The docker stack will remain up so you rerun the tests using npm test.
Use npm run cypress:open to open the Cypress Test Runner. This allows you to run a test and watch it. This is recommended when writing or debugging a test. This requires the docker test stack to be running. Use npm test or npm run test:boot first.
Use npm run test:down to remove the docker test stack.
Folder Structure
New tests can be added to test\e2e\cypress\integration. See writing tests.
Reference
Test Ports
| Port | Container |
|---|---|
| 8088 | AppBuilder |
| 8889 | Database |
Intro to writing tests
These two commands are always running in the background while you write tests:
$npm run test:boot
$npm run cypress:open
Cypress open will give you this window where you can run any test in /integration:
There are two places you will spend your time working:
The logic: what buttons are clicked, typed in, and checked to see if data saved properly
The interface: this JSON is what is accessed by the ‘cyInterfaceCARS’ in the logic.
(VScode will prompt you with a variable on the logic side if it exists in the structure)
