It's easy to get your Selenium and Appium tests up and running with Sauce through a few basic steps. For more detailed information, you can check out the topics under Web Application Testing and Mobile Application Testing.
Before Running Your Test
Setting Up Your Test
- Set up your test to connect to the Sauce Labs browser cloud using your account credentials.
The exact configuration depends on the language you're using in your script. The scripts in Sauce Labs Demonstration Scripts include examples in various languages that walk through setting up your authentication credentials and specifying the path to the Sauce Labs cloud.
- Use the Platform Configurator to specify the Desired Capabilities of your test.
Desired Capabilities are the mechanism in Selenium and Appium that lets you specify the combination of platform, operating system, and browser that you want to use in your website tests. You can find out more about using Desired Capabilities in the topics under Test Configuration and Annotation, as well as in the Selenium and Appium documentation. You can also check out some Examples of Test Configuration Options for Automated Website Tests and Examples of Test Configuration Options for Mobile Application Tests.
- Make sure your test is set up to report results to your Sauce Labs dashboard.
On its own, Selenium only knows if a test has completed or not. If you want more information, like whether the website passed or failed the test, you need to set up reporting to the Sauce Labs dashboard. As with the case of setting up your authentication credentials, the exact reporting configuration depends on the language you're using in your test script. The scripts in Example Selenium Scripts for Automated Web App Tests include examples of how to enable reporting for each language. You can also use the Sauce Labs REST API to annotate your tests after they have completed, including pass/fail status.
Running Your Test
- Log in to the Sauce Labs web interface.
You don't need to be logged in to run your test, but if you are you can watch your test run and the results appear in the dashboard.
- On your local machine, run your test script.
That's it! As your test script executes you'll see the results appear in your dashboard.
After Running Your Test
Now that you've run your first test with Sauce, you're ready to explore more advanced functionality!