Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

OptionDescriptionKeyValue TypeExample

Selenium Version

Allows you to choose the version of Selenium you want to use for your test.

For Firefox, the default version of Selenium when no value is specified depends on the version of Firefox.

Expand
titleFirefox and Selenium Versions
Firefox VersionSelenium Version
Firefox 47Selenium 2.53.1 only
Firefox 46Selenium 2.51.0 2.52.0 2.53.0, 2.53.1
Firefox 44 - 45Selenium 2.48.0, 2.50.0, 2.51.0, 2.52.0, 2.53.0
Firefox 39 - 43Selenium 2.47.1, 2.48.0, 2.50.0, 2.51.0, 2.52.0, 2.53.0
Firefox 38Selenium 2.46.0
Firefox 32 - 37Selenium 2.45.0
Firefox 26 - 31Selenium 2.40.0
Firefox 23 - 25Selenium 2.35.0
Firefox 21 - 22Selenium 2.33.0
Firefox 20Selenium 2.31.0
Firefox 19Selenium 2.30.0
Firefox 17 - 18Selenium 2.29.0
Firefox 12 - 16Selenium 2.27.0
Firefox 11 and belowSelenium 2.18.0

"Marionette" replaces the Firefox driver in Firefox 48+. Its binary is called geckodriver (previously wires). The version we use depends on whether the job is Selenium 2 or 3:

  • For Selenium 2, the marionette (geckodriver) version is 0.9.0
  • For Selenium 3, the marionette (geckodriver) version is 0.11.1
  • For Firefox 53 and above, the marionette (geckodriver) version is 0.16.0
  • For Firefox 55 and above, the marionette (geckodriver) version is 0.18.0
  • For Firefox 57 and above, the marionette (geckodriver) version is 0.23.0

Note

When testing with Chrome and Internet Explorer, Selenium Version is not used to determine the version of the ChromeDriver or IEDriver that is used. For these browsers you should set the driver version as described for the Chrome Driver Version and Internet Explorer Driver Version options.

seleniumVersionstring

"seleniumVersion": "2.46.0"

Include Page
_selenium_version
_selenium_version

Chrome Driver Version

Sauce Labs supports the ChromeDriver version 1 series (i.e. 26.0.1383.0) and . the version 2 series (i.e. 2.15). 45) and the latest convention where each Chrome version comes with its own matching ChromeDriver version (from Chrome 73 onwards). See http://chromedriver.chromium.org/downloads for more information.

The default version of ChromeDriver when no value is specified depends on the version of Chrome used.

NOTE: This capability only applies to Desktop Chrome tests

Expand
titleChrome and Chrome Driver Versions
Chrome VersionChrome Driver Version
Chrome 74ChromeDriver 74
Chrome 73ChromeDriver 73
Chrome 72ChromeDriver 2.45
Chrome 71ChromeDriver 2.44
Chrome 69-70ChromeDriver 2.43
Chrome 68ChromeDriver 2.41
Chrome 67ChromeDriver 2.40
Chrome 65-66ChromeDriver 2.38
Chrome 64ChromeDriver 2.37
Chrome 62-63ChromeDriver 2.34
Chrome 61ChromeDriver 2.32
Chrome 60ChromeDriver 2.29
Chrome 59ChromeDriver 2.29
Chrome 58ChromeDriver 2.29
Chrome 57ChromeDriver 2.28
Chrome 56ChromeDriver 2.28
Chrome 55ChromeDriver 2.28
Chrome 54

ChromeDriver 2.27

Chrome 53ChromeDriver 2.26
Chrome 52ChromeDriver 2.24
Chrome 51ChromeDriver 2.23
Chrome 46-50ChromeDriver 2.21
Chrome 40-45ChromeDriver 2.15
Chrome 37-39ChromeDriver 2.11
Chrome 33-36ChromeDriver 2.10
Chrome 31-32ChromeDriver 2.8
Chrome 29-30ChromeDriver 2.4
Chrome 28 and belowChromeDriver 26.0.1383.0
chromedriverVersionstring

"chromedriverVersion": "2.1545"

Expand
titleSupported Chrome Drivers


  • 21.0.1180.0
  • 23.0.1240.0
  • 26.0.1383.0
    • 0.6
    • 0.7
    • 0.8
    • 0.9
    • 2.0
    • 2.1
    • 2.2
    • 2.3
    • 2.4
    • 2.5
    • 2.6
    • 2.7
    • 2.8
    • 2.9
    • 2.10
    • 2.11
    • 2.12
    • 2.13
    • 2.14
    • 2.15
    • 2.20
    • 2.21
    • 2.22
    • 2.23
    • 2.24
    • 2.26
    • 2.27
    • 2.28
    • 2.29
    • 2.30
    • 2.31
    • 2.32
    • 2.33
    • 2.34
    • 2.35
    • 2.36
    • 2.37
    • 2.38
    • 2.39
    • 2.40
    • 2.41
    • 2.43
    • 2.44
    • 2.45
    • 2.46
    • 73
    • 74

Internet Explorer Driver Version

The Internet Explorer Driver defaults to version 2.53.1 when no version is specified.

Note that the versions of Internet Explorer Driver we have available correspond to major Selenium releases - we do not have all the minor point releases (e.g. 3.12.0.4) available.

We recommend setting the Selenium Version (see above) to correspond with the Internet Explorer Driver version you select.

Sauce Labs supports launching 64-bit IE on our 64-bit VMs: Windows 7, Windows 8, and Windows 8.1. This provides a workaround for two known Selenium issues:

  1. Using a 32 bit driver on a 64 bit operating system causes Selenium's screenshot feature to only capture the part of the page currently visible in the browser viewport Selenium Issue 5876.
  2. Using a 64 bit driver on a 64 bit operating system causes text entry to be extremely slow Selenium Issue 5516.
iedriverVersionstring

"iedriverVersion": "23.46141.0"

Expand
titleSupported IE Drivers
  • x64_2.29.0
  • x64_2.39.0
  • x64_2.40.0
  • x64_2.41.0
  • x64_2.42.0
  • x64_2.43.0
  • x64_2.44.0
  • x64_2.45.0
  • x64_2.46.0
  • x64_2.48.0
  • 2.21.1
  • 2.21.2
  • 2.24.0
  • 2.25.3
  • 2.26.0
  • 2.28.0
  • 2.29.0
  • 2.30.1
  • 2.31.0
  • 2.32.2
  • 2.33.0
  • 2.34.0
  • 2.35.0
  • 2.35.1
  • 2.35.2
  • 2.35.3
  • 2.36.0
  • 2.37.0
  • 2.38.0
  • 2.39.0
  • 2.40.0
  • 2.41.0
  • 2.42.0
  • 2.43.0
  • 2.44.0
  • 2.45.0
  • 2.46.0
  • 2.48.0
  • 2.49.0
  • 2.50.0
  • 2.51.0
  • 2.52.0
  • 2.52.1
  • 2.52.2
  • 2.53.0
  • 2.53.1
  • 3.0.0
  • 3.1.0
  • 3.2.0
  • 3.3.0
  • 3.3.1
  • 3.4.0
  • 3.5.0
  • 3.5.1
  • 3.6.0
  • 3.7.0
  • 3.8.0
  • 3.9.0
  • 3.10.0
  • 3.11.0
  • 3.11.1
  • 3.12.0
  • 3.13.0
  • 3.14.0
  • 3.141.0


...

Table of Content Zone
minLevel4
locationtop
printablefalse
OptionDescriptionKeyValueExample

Disable video recording

By default, Sauce records a video of every test you run. This is generally handy for debugging failing tests, as well as having a visual confirmation that certain feature works (or still works!) However, there is an added wait time for screen recording during a test run.


recordVideo
boolean
"recordVideo": false

Disable video upload for passing tests

As an alternative to disabling video recording, the  videoUploadOnPass  setting will let you discard videos for passing tests identified using the passed  setting. This disables video post-processing and uploading that may otherwise consume some extra time after your test is complete.videoUploadOnPassboolean"videoUploadOnPass": false

Disable step-by-step screenshots

Sauce captures step-by-step screenshots of every test you run. Most users find it very useful to get a quick overview of what happened without having to watch the complete video. However, this feature may add some extra time to your tests. You can avoid this by optionally turning off this feature.recordScreenshotsboolean"recordScreenshots": false

Disable log recording

By default, Sauce creates a log of all the actions that you execute to create a report for the test run that lets you troubleshoot test failures more easily.

Note
titleSelenium Logs Are Still Recorded

This option only disables recording of the log.json file. The selenium-server.log will still be recorded even if you choose to disable recording of the log.json.

recordLogsboolean"recordLogs": false

Prioritize Jobs

If you have multiple new jobs waiting to start, for example across a collection of sub-accounts, jobs with a lower priority number take precedence over jobs with a higher number. So, for example, if you have multiple jobs simultaneously waiting to start, we'll first attempt to find resources to start all the jobs with priority 0, then all the jobs with priority 1, etc. When we run out of available virtual machines, or when you hit your concurrency limit, any jobs not yet started will wait. Within each priority level, jobs that have been waiting the longest take precedence.priorityinteger"priority": 0

Enable WebDriver's automatic screen shots

Selenium WebDriver captures automatic screenshots for every server side failure, for example if an element is not found. Sauce disables this by default to reduce network traffic during tests, resulting in a considerable performance improvement in most tests. You can enable this feature, but keep in mind that it may be detrimental to the performance of your jobs. webdriver.remote.quietExceptionsboolean"webdriver.remote.quietExceptions": false

Enable Extended Debugging

Extended debugging records HAR files for some browsers, as well as console.json logs. These are extremely valuable for debugging flaky tests. Default value is false.

See Debugging Tests with JavaScript Console Logs and HAR Files (Extended Debugging) for more information.

extendedDebuggingboolean"extendedDebugging": true

Enable Performance Capture

Sauce Performance Testing can be enabled by setting both extendedDebugging and capturePerformance to true. Default value is false.

See Getting Started with Sauce Performance for more information.

capturePerformanceboolean"capturePerformance": true