Cypress commands


A collection of high-quality Cypress commands to complement and extend the defaults.

This repository is not maintained by the Cypress developers. This means we can choose to ignore
parts of their vision.

Documentation is a cornerstone of Cypress, the commands in this repository will try to keep these
documentation standards.

Cypress version

cypress-commands should work with the latest version of Cypress. If this is not the case, please
open an issue.

It's tested against multiple versions of Cypress. See the
CI definition for the most up-to-date list.

Installation

Install the module.

``shell
npm install cypress-commands
`

Add the following line to cypress/support/index.js.

`javascript
require('cypress-commands');
`

$3

Import typescript definitions by adding them to your tsconfig.json. Add the cypress-commands types
before the Cypress types so intellisense will prefer the cypress-commands versions of extended
commands.

`json
{
"compilerOptions": {
"types": ["cypress-commands", "cypress"]
}
}
`

#### Known issue: cypress.config.ts limitation

Due to the way Cypress defines its types, it's currently not possible for plugin authors to extend
the Cypress config types.

Because of this limitation, it's not possible to set the requestBaseUrl option in
cypress.config.ts. For the time being, you can work around this limitation by using
cypress.config.js instead.

See https://github.com/cypress-io/cypress/issues/22127 for more details.

Extended commands

These commands have been extended to be able to do more than originally intended. For these
commands, all tests that exist in the Cypress repository are copied to make sure the default
behaviour stays identical unless we want it changed.

- .request()
- .then()

Added commands

These commands do not exist in Cypress by default.

- .attribute()
- .text()
- .to()

Contributing

Contributors are always welcome! I don't care if you are a beginner or an expert, all help is
welcome.

Running tests

First clone the repository and install the dependencies.

$3

`shell
npm start
`

$3

`shell
npm test
``