Sauce Labs Documentation November 2015, v1.0 Copyright Sauce Labs 2015 1. Quick Start . 5 1.1 Instant C# Tests with Sauce Labs . 6 1.2 Instant JavaScript Unit Testing with Sauce Labs . 9 1.3 Instant Java Tests with Sauce Labs . 10 1.4 Instant Node.js Tests with Sauce Labs . 13 1.5 Instant PHP Tests with Sauce Labs . 19 1.6 Instant Python Tests with Sauce Labs . 24 1.7 Instant Ruby Tests with Sauce Labs . 29 2. Known Issues and Bugs . 32 3. Introducing Sauce Labs . 33 3.1 A Tour of the Sauce Labs Interface . 34 3.2 Sauce Labs FAQs . 36 3.3 Sauce Labs Basics . 38 3.4 Supported Browsers and Operating Systems . 39 4. Running Tests with Sauce Labs . 40 4.1 Tips and Best Practices for Running Tests with Sauce Labs . 42 4.1.1 Best Practices for Running Tests with Sauce Labs . 43 4.1.1.1 Best Practice: Avoid External Test Dependencies . 44 4.1.1.2 Best Practice: Avoid Dependencies between Tests to Run Tests in Parallel . 45 4.1.1.3 Best Practice: Don't Use Brittle Locators in Your Tests . 47 4.1.1.4 Best Practice: Have a Retry Strategy for Handling Flakes . 48 4.1.1.5 Best Practice: Keep Functional Tests Separate from Performance Tests . 49 4.1.1.6 Best Practice: Use Build IDs, Tags, and Names to Identify Your Tests . 50 4.1.1.7 Best Practice: Use Environment Variables for Authentication Credentials . 51 4.1.1.8 Best Practice: Use Explicit Waits . 53 4.1.1.9 Best Practice: Use the Latest Version of Selenium Client Bindings . 55 4.1.1.10 Best Practices: Use Small, Atomic, Autonomous Tests . 56 4.1.2 Tips for Lean, Speedy Tests with Sauce Labs . 57 4.1.3 Handling Authentication . 59 4.1.3.1 Basic HTTP Authentication . 60 4.1.3.2 Injecting Cookies to Bypass Authentication Dialogs . 61 4.1.3.3 Running an AutoIt Script as a Pre-run Executable to Handle Windows Security Authentication Dialogs . 62 4.2 Pre-Run Executables . 63 4.2.1 Setting Up Pre-Run Executables . 64 4.3 Test Configuration and Annotation . 65 4.3.1 Configuring Tests with the WebDriver API DesiredCapabilities . 66 4.3.2 Configuring Tests with the Sauce Labs REST API . 67 4.3.3 Configuring Tests with Selenium's JavaScript Executor . 69 4.3.4 Test Configuration Options . 70 4.3.5 Examples of Desired Capabilities for iWebDriver and Appium iOS Tests . 79 4.4 Manual Testing with Sauce Labs . 81 4.4.1 Running a Manual Testing Session . 82 4.4.2 Starting Manual Tests from Automated Tests . 83 4.4.3 Troubleshooting Manual Tests . 84 4.5 Automated Testing with Sauce Labs . 86 4.5.1 Troubleshooting Automated Tests . 87 4.5.2 Common Error Messages . 89 4.6 Mobile Testing with Sauce Labs . 92 4.6.1 Mobile Testing with Appium . 93 4.6.2 Support and Requirements for Mobile Testing . 95 4.6.2.1 Supported Android Emulators . 96 4.6.2.2 Supported Mobile Operating Systems . 98 4.6.2.3 Requirements for Testing Mobile Native and Hybrid Applications . 99 4.6.3 Manual Testing for Mobile Apps . 100 4.6.3.1 Getting to the JavaScript Console for Manual iOS Browser Tests . 101 4.6.4 Running Emulator and Simulator Mobile Tests . 102 4.6.5 Types of Mobile Tests . ..