saucectl -- the Sauce Labs test orchestrator CLI allows you to run Cypress tests directly from your existing Cypress project.
- Don't have Cypress yet?
saucectlcan set up your initial project directory and give you a sample test to run.
- Already running Cypress? Let
saucectlrun your tests in the Sauce Labs Cloud, where you have access to thousands of OS/browser combinations and Sauce Labs analytics.
- A Sauce Labs account (if you don't have one, start a free trial)
- Download and install
- Ensure you've met the prerequisites outlined in the Testrunner Toolkit documentation
You can run a working Cypress sample test in under ten minutes!
Begin by installing the
saucectl CLI in the root directory of your existing Cypress project or your intended directory.
saucectl requires access to a valid Sauce Labs account.
- Run the
- Enter your Sauce Labs Username and Access Key at the prompts.
.gitignorefile to protect it from unintended exposure.
saucectl to run your Cypress tests and view them in the Sauce Labs app requires a directory structure that includes the Cypress project and the Sauce configuration keys. Please clone our cypress example repository.
run command to execute the sample test included with the
saucectl installation or whichever test suites you have defined in the configuration file.
The console displays the executing tests, distinguishing which mode is running.
The results and test assets are immediately available in the Sauce Labs dashboard: