Update: the content on this blog post is out of date. Please visit our documentation Wiki for a current list of common error messages.
Ever run into an error message on Sauce you don't understand? Alex put this handy list of error messages on Sauce together. You can find the original doc here. This will soon be available for reference on Sauce's website, but in the meantime, brush up on the error messages you might see on Sauce and what they mean.
==== AUTOMATED JOB ERRORS: ====
-- Invalid credentials --
Some combination of the following error messages will be thrown: OpenQA.Selenium.WebDriverException : Unexpected error. Unknown username. You sent username 'None' in your browser string, which is not a valid Sauce Labs account. OpenQA.Selenium.WebDriverException : Unexpected error. Invalid Credentials. org.openqa.selenium.UnsupportedCommandException: Invalid Credentials. You sent the access key 'None' but it does not match the access key associated with your account. Please login to saucelabs.com to retrieve a valid access key. This indicates that Selenium could not parse the credentials you sent. If you're using "access-key" in your test setup, try replacing it with "accessKey", or vice versa, as it's language-dependent.
-- User Terminated --
This means that you ended the job, either through the "Cancel Job" button, by jumping into an automated session from the Sauce website, or via a breakpoint. Since this terminates the job immediately and hands over control to you, the test will not upload any screenshots, video, or logs that were collected previously.
-- Timeout errors --
1. "Test did not see a new command for 90 seconds. Timing out."
2. "Selenium took too long to run your command"
3. "Test exceeded maximum duration after 1800 seconds"
Sauce builds in a few default timeouts to keep uncontrolled tests from eating up your minutes. Here's a brief rundown on what each of the available timeout settings does:
1. The "idle-timeout" (default 90 seconds) ends the job if no commands are received from your Selenium script.
2. The "command-timeout" (default 5 minutes) ends the job if a single command takes too long to run.
3. And the "max-duration" timeout (default 30 minutes) ends the job if your entire test takes longer than you want.
You can set these to different values using "desired capabilities" settings in the setup of your test, as described at the URL above.
-- Unsupported OS/browser/version combo --
Check to make sure that the browser, browser-version, and platform settings you're using are in our supported list.
-- Browser failed to start --
The twin sibling of "Unsupported version", this message means that something a little more unusual is off in your test setup. Usually, this means that you're specifying a Selenium version that isn't compatible with the browser/version/OS you've selected. (For example, you should not be setting this for any mobile tests.)
Try simply omitting that setting, and if you still see the issue, feel free to write to email@example.com with a description of the issue and a copy of your setup code.
-- Client disconnected during getNewBrowserSession request --
This means that your test runner decided to end the job before it had fully initialized on Sauce's end. There are a few potential causes:
1. You're running too many tests at a time: Check the left sidebar on your Account page. It shows a "Parallel tests" number, which is the maximum number of tests you can run at a time, based on your subscription level. If your account can run 2 parallel tests, and you're launching 10, 8 will be "queued" until one of your tests finishes and a slot frees up. However, if this takes a long time, your test runner may choose to end the queued jobs after a few minutes instead of waiting. Just make sure you're launching a reasonable number of simultaneous tests for your account.
2. High job wait times: Check our status page and/or follow @sauceops on Twitter for up-to-the-minute news about any issues within the service. If something causes demand for certain VMs to stack up, your jobs may be queued and (as above) terminated by your test runner.
Tests that end this way are never taken out of your minutes.
-- Runaway execution. Please contact firstname.lastname@example.org for assistance. --
This message means that an error has been detected in the VM or in Selenium, which caused the test to behave abnormally, and Sauce detected this and shut down the job. These are very rare and usually do not recur. If you do see more than one on the same test, let us know.