You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
55 lines
2.9 KiB
Markdown
55 lines
2.9 KiB
Markdown
|
|
2. cd to `cypress-example` folder and run `npm install`
|
|
|
|
## :heavy_check_mark: Run tests
|
|
|
|
- If you installed Cypress via npm:
|
|
- cypress test runner (cypress __open__):
|
|
- **`npm run cy:open:web`** OR `cypress open --env device=web` (change web to mob to switch to mobile view)
|
|
|
|
- cypress __headless mode__ (cypress run):
|
|
- `npm run cy:run:web` OR `cypress run --env device=web`
|
|
- If you installed Cypress zip:
|
|
- import **`cypress-example`** folder and you are good to go
|
|
|
|
## :bulb: Information
|
|
:information_source: _Feel free to delete `.circleCI` folder and `Jenkinsfile` from your machine. (These files are for CI to run tests automatically once a week)_
|
|
#### :test_tube: Tests
|
|
:file_folder: Tests are located in `cypress/e2e` folder
|
|
|
|
:file_folder: Custom commands are located in `cypress/support` folder (`.cmd.js` suffix)
|
|
|
|
:file_folder: Selectors (CSS selectors) are located in `cypress/selectors` folder [only difference from cypress default project structure] - __not__ using page object model(POM) design pattern but keeping selectors (only selectors) separately [Read more](https://github.com/helenanull/cypress-example#grey_question-qa)
|
|
|
|
### Stress test
|
|
|
|
NOTE: this portion is dependant on having the following library installed: cypress-utils
|
|
This is available here: https://github.com/trentrand/cypress-utils.git
|
|
|
|
|
|
To ensure your Cypress tests are not irregularly failing with false-negatives, stress testing new test files can be a reliable way of filtering out bad test code.
|
|
|
|
To stress test one or more test files, simply specify the files to run:
|
|
|
|
```shell
|
|
cypress-utils stress-test specFileA specfileB
|
|
```
|
|
|
|
Additional command-line options may be specified, such as the sample size or number of concurrent threads:
|
|
```shell
|
|
cypress-utils stress-test --trialCount 12 --threads 4
|
|
```
|
|
|
|
> See more command-line options with `cypress-utils stress-test --help`
|
|
|
|
|
|
|
|
#### :hammer_and_wrench: Configuration
|
|
Config files:
|
|
1. `cypress.config.js` - Main config file where default behavior of Cypress can be modified. [More info](https://docs.cypress.io/guides/references/configuration)
|
|
2. `plugins/index.js` - Plugins file is where we can programmatically alter the resolved configuration [More info](https://docs.cypress.io/guides/tooling/plugins-guide#Use-Cases)
|
|
|
|
This test suite is supporting multiple viewports (mobile and desktop). See `plugins/index.js` file
|
|
|
|
One solution is to use [cy.viewport()](https://docs.cypress.io/api/commands/viewport) command inside the test, to change the viewports, but very often websites also check user agent to get the device information(and show the mobile view). Since user agent is something [we can't change in the middle of the test](https://github.com/cypress-io/cypress/issues/2100), we need to pass config value when launching tests. In `cypress.config.js` we have a `device` parameter and in plugins file `index.js`, we decide viewports and user agent parameter values based on that device value.
|