Cypress on Sauce Labs
Cypress is an end-to-end JavaScript testing framework that you can use to test your web apps remotely on Sauce Labs cloud using the saucectl CLI.
System Requirements
Supported OS:
- Windows 10 / Windows 11
- macOS 10.15+
- Linux
Supported Languages
JavaScript is supported out of the box. TypeScript and Cucumber are also supported, but require additional dependencies at runtime. See our example repo for working end-to-end examples.
Supported Testing Platforms
Sauce Labs supports the following test configurations for Cypress:
| Cypress Version | Supported Platforms | Supported Browsers | End of Life |
|---|---|---|---|
| 12.17.4 | macOS: 11.00, 12, 13 | Chrome, Firefox, Microsoft Edge, Webkit (Experimental) | August 31, 2024 |
| Windows: 10, 11 | |||
| 12.17.2 | macOS: 11.00, 12, 13 | Chrome, Firefox, Microsoft Edge, Webkit (Experimental) | August 1, 2024 |
| Windows: 10, 11 | |||
| 12.14.0 | macOS: 11.00, 12, 13 | Chrome, Firefox, Microsoft Edge, Webkit (Experimental) | June 16, 2024 |
| Windows: 10, 11 | |||
| 12.11.0 | macOS: 11.00, 12, 13 | Chrome, Firefox, Microsoft Edge, Webkit (Experimental) | May 11, 2024 |
| Windows: 10, 11 | |||
| 12.6.0 | macOS: 11.00, 12, 13 | Chrome, Firefox, Microsoft Edge, Webkit (Experimental) | Mar 01, 2024 |
| Windows: 10, 11 | |||
| 12.3.0 | macOS: 11.00, 12, 13 | Chrome, Firefox, Microsoft Edge, Webkit (Experimental) | Jan 15, 2024 |
| Windows: 10, 11 | |||
| 11.2.0 | macOS: 11.00, 12, 13 | Chrome, Firefox, Microsoft Edge, Webkit (Experimental) | Nov 30, 2023 |
| Windows: 10, 11 | |||
| 10.10.0 | macOS: 11.00, 12, 13 | Chrome, Firefox, Microsoft Edge, Webkit (Experimental) | Oct 20, 2023 |
| Windows: 10, 11 | |||
| 10.7.0 | macOS: 11.00, 12, 13 | Chrome, Firefox, Microsoft Edge | Sep 7, 2023 |
| Windows: 10, 11 | |||
| 8.6.0 | Windows: 10 | Chrome, Firefox, Microsoft Edge | Oct 13, 2022 |
How to Get Started
- Quickstart: Use our demo repo to quickly set up and run a sample Cypress project and test to see the results.
- Run your own tests: Customize
saucectlto run your existing tests just by modifying theconfig.ymlfile for your project. - Try Cypress with Cucumber:
saucectlsupports Cypress using Cucumber, and the demo repo includes examples for Cypress 9 and below and Cypress 10 and above. - Incorporate saucectl in your pipeline: Cypress on Sauce supports CI integrations with Circle CI, GitLab, Jenkins, and GitHub Actions.
Cypress Plugin for Sauce Labs
If you would prefer to stay in Cypress, try the new Cypress Sauce Labs Plugin. Connect to your Sauce Labs account from within your Cypress project to configure and run your tests directly from Cypress.
Limitations
Special Characters in Test Names
We recommend that you avoid the use of special characters when naming your tests. If your test name contains any special characters, your test may not run or its artifacts may not be visible in our platform.
Cypress 11+
A bug impacting Cypress 11+ is causing the Cypress UI to display a browser that is not the one actually used. Edge is shown on Windows, and Webkit is shown on macOS.
The browser selected in your configuration file is used, and the console log of Cypress is still correct.
The issue has been reported to Cypress. See: https://github.com/cypress-io/cypress/issues/25755 for more information.
Firefox 101 + Windows
Cypress does not currently work with Firefox 101 on Windows.
Firefox 105
Cypress does not currently work with Firefox 105. See https://github.com/cypress-io/cypress/issues/23897 for more information.
Webkit
- Cypress only supports launching Webkit with a fixed resolution of 1280x720.
- Cypress 12.6.0 does not work on Windows with Webkit browser.
- Cypress 12+ does not work on macOS 11 with Webkit browser.