Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/Lakitna/cypress-commands
A collection of Cypress commands to extend and complement the defaults
https://github.com/Lakitna/cypress-commands
cypress cypress-plugin
Last synced: 29 days ago
JSON representation
A collection of Cypress commands to extend and complement the defaults
- Host: GitHub
- URL: https://github.com/Lakitna/cypress-commands
- Owner: Lakitna
- License: mit
- Created: 2019-03-28T14:24:09.000Z (over 5 years ago)
- Default Branch: develop
- Last Pushed: 2023-02-08T23:46:00.000Z (almost 2 years ago)
- Last Synced: 2024-11-06T03:06:37.151Z (about 1 month ago)
- Topics: cypress, cypress-plugin
- Language: JavaScript
- Homepage:
- Size: 1.05 MB
- Stars: 158
- Watchers: 5
- Forks: 16
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
- awesome-cypress - Cypress Commands - A collection of Cypress commands to extend and complement the defaults; (Uncategorized / Uncategorized)
README
# Cypress commands
[](https://badge.fury.io/js/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](./.github/workflows/ci.yaml) 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');
```
### Type definitions
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()`](./docs/request.md)
- [`.then()`](./docs/then.md)
## Added commands
These commands do not exist in Cypress by default.
- [`.attribute()`](./docs/attribute.md)
- [`.text()`](./docs/text.md)
- [`.to()`](./docs/to.md)
## 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.
### GUI mode
```shell
npm start
```
### CLI mode
```shell
npm test
```