Skip to main content

Playwright Quickstart

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

  • Don't have Playwright tests but want to try? The Playwright Demo Repo includes a sample project structure, working configuration file, and sample Playwright test so you can get up and running in less than 10 minutes!
  • Already running Playwright? 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 Playwright Project#

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

Step 4: Run Tests#

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

saucectl run

The console displays the executing tests, distinguishing which mode is running, and the results and test assets are available immediately in your Sauce Labs account.