This is the e2e automated testing suite for the Ushahidi platform. The tests are written in js and they run in cypress.
Test files are named according to the functionality covered. Login covers login steps, roles covers roles, surveys covers surveys and so on and so forth. Each file is put into its own respectively named folder, and each folder prefixed with a number in ascending order. This is so that the folders are arranged in order starting from 1 in the test runner. When all the tests are run, they will run in this order.
Each main test file has two associated files:
Named to match the associated test file. Most elements on the platform have custom attributes added to them in the format data-qa="element_name"
This is then declared in the locators file and referred to from the test files.
Locators folder has files that have custom element selectors. Locator files sit here.
Named to match the associated test file. Functions file has the core functions for the tests. The main test file calls from from the functions file located in the Functions folder.
Requires node v18+
npm installwill install the current cypress version the tests are written and running in.
Check out Cypress.io for more information
Once cypress is set up and running, simply open the runner and click on individual tests to run. Tests can be run in headless mode in the terminal using the default command:
npx cypress runTo launch the cypress test runner, use the command:
npm run cy:openThis will launch the test runner laying out available tests, and individual tests can be run on a browser on a visual interface.
The site under test runs on a remote staging server - https://mzima.staging.ush.zone/
The tests would require logging into the site. User credentials are declared in the cypress.env.json file. Contact the site owners for admin credentials to run the tests.
Refer to the CONTRIBUTING.md guide for details.