Skip to main content

TestCafe Quickstart

Use saucectl -- the Sauce Labs test orchestrator CLI -- to run TestCafe tests directly from your existing TestCafe project.

  • Don't have TestCafe tests but want to try? The TestCafe Demo Repo includes a sample project structure, working configuration file, and sample TestCafe test so you can get up and running in less than 10 minutes!
  • Already running TestCafe? Let saucectl run your tests in the Sauce Labs Cloud, where you have access to thousands of OS/browser combinations and Sauce Labs analytics.

What You'll Need#

Step 1: Install saucectl#

npm install -g saucectl

Step 2: Link Your Sauce Labs Account#

saucectl requires access to a valid Sauce Labs account.

  1. Run the configure command:
    saucectl configure
  2. Enter your Sauce Labs Username and Access Key at the prompts.
Use Environment Variables

You can set your Sauce Labs credentials as environment variables instead of generating a credentials.yml, if you prefer. In systems where both sets of credentials exist, environment variable values are prioritized.

Step 3: Set up Your TestCafe Project#

Check out the TestCafe Demo Repo to get a TestCafe project structure, TestCafe-ready configuration file, and sample TestCafe test.

Step 4: Run Tests#

Use the run command to execute the sample test included with the saucectl installation.

saucectl run

The console displays the executing tests, distinguishing which mode is running.

The results and test assets are available immediately in your Sauce Labs account: