MyAudi integration tests

Integration tests of the myAudi website and the Audi backends. cypress is used as testing framework.

Run

Prerequisites:

• yarn

To install everything, run:

yarn

During development and writing tests you can use the cypress GUI. The hot-reloading GUI will run you tests. You can also use it for debugging.

yarn open

To just run all tests in the CLI and with headless chrome:

yarn test

Configuration

The test environment and test data are configured in cypress/config/. You can create a new config there and select it with the environment variable CYPRESS_PROFILE (filename). You can also set the base url with the environment variable CYPRESS_WEBSITE_BASE_URL.

Default test data is cypress/config/intm2.ts.

Add new tests

All tests live in cypress/integration. Every page has it's own test file. If you add a new test, add it to the already existing test file, or create a new one if there is none for your page.

To make tests more readable, we use the page object pattern. This is just an abstraction of the selector methods. You can find the page objects in cypress/support/page.

Misc

• Cypress documentation:
  • Guides: https://docs.cypress.io/guides/
  • API: https://docs.cypress.io/api/
  • Best practices: https://docs.cypress.io/api/cypress-api/custom-commands.html#Best-Practices
• if a test get's skipped via .skip(), it will be shown as pending in the test results
  • https://github.com/cypress-io/cypress/issues/3092
• basic auth configuration only applies to a specific domain, and not to any other subdomains. this is why the login is done manually
  • https://github.com/cypress-io/cypress/issues/4646

Report

Test Report

To create a nice HTML report:

# run all tests and create a report
yarn test:report

# convert the mocka report to a HTML report
yarn report:convert-to-html

# open mochawesome-report/mochawesome.html in your browser