Selenium Test Options

Below you'll find various options you can specify in your tests.
You can add the options in the Desired Capabilities of your test, which is the place in your test file where you also specify the browserName and browser version.

Annotating with Selenium's JavaScript Executor

If you are running Javascript tests, you can use custom javascript commands to communicate with our API.
Please see Methods for Configuring and Annotating Tests for more information.

Make screenshots of your tests

boolean screenshot
Default: false
By default we do not capture screenshots at every step of your test. If you wish to take a screenshot for every step, please add this capability (set to true) to your request.

Make a video of your tests

boolean screenrecorder
Default: true
By default we record a video of your test, which is accessible in the member area. If you do not wish to have this, you can disable it with this option.
Video should not slow down your test considerably.

Use a specific version of Selenium

string selenium-version
Default 2.51.0
By default we use the latest Selenium version to run your test.
If you wish to use another Selenium version for your test, please specify one of the following available versions:
  • 3.3.1
  • 3.3.0
  • 3.2.0
  • 3.1.0
  • 3.0.1
  • 3.0.0
  • 2.53.0
  • 2.52.0
  • 2.51.0
  • 2.50.0
  • 2.49.0
  • 2.48.0
  • 2.47.0
  • 2.46.0
  • 2.45.0
  • 2.44.0
  • 2.43.0
  • 2.42.0
  • 2.41.0
  • 2.40.0
  • 2.39.0
  • 2.38.0
  • 2.37.0
  • 2.36.0
  • 2.35.0
  • 2.34.0
  • 2.33.0
  • 2.32.0
  • 2.31.0
  • 2.30.0
  • 2.29.0
  • 2.28.0
  • 2.27.0
  • 2.26.0
  • 2.25.0
  • 2.24.0
  • 2.23.0
  • 2.22.0
  • 2.21.0
  • 2.20.0
  • 2.19.0
  • 2.18.0
  • 2.17.0
  • 2.16.0
  • 2.15.0
  • 2.14.0
  • 2.13.0
  • 2.12.0
  • 2.11.0
  • 2.10.0
  • 2.9.0
  • 2.8.0
  • 2.7.0
  • 2.6.0
  • 2.5.0
  • 2.4.0
  • 2.3.0
  • 2.2.0
  • 2.1.0
  • 2.0.0


string chromedriverVersion
Possible values: 2.10, 2.12, 2.13, 2.14, 2.15, 2.16, 2.19, 2.20, 2.21, 2.22, 2.23, 2.24, 2.25, 2.26, 2.27, 2.28
We support using custom ChromeDriver versions during your tests. By default the most recent Chromedriver is used according to the version of Chrome you're testing on.

Internet Explorer Driver (IEDriver)

string iedriverVersion
Possible values: 2.45.0, 2.46.0, 2.47.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.1.0, 3.2.0, 3.3.0, x64_2.45.0, x64_2.46.0, x64_2.47.0, x64_2.48.0, x64_2.49.0, x64_2.50.0, x64_2.51.0, x64_2.52.0, x64_2.52.1, x64_2.52.2, x64_2.53.0, x64_2.53.1, x64_3.1.0, x64_3.2.0, x64_3.3.0
We provide both 32-bit and 64-bit versions of the Internet Explorer driver. By default we use the most recent 32-bit IEDriver for your tests. We use 32-bit because of a slow text entry bug with the 64-bit version.

For our screenshots, we use the 64-bit version, because of a screenshot problem with the 32-bit version.

Firefox Driver (Geckodriver)

string geckodriverVersion
Possible values: 0.15.0, 0.14.0, 0.13.0, 0.12.0, 0.11.0, 0.10.0, 0.9.0, 0.8.0, 0.7.1, 0.6.2
For Firefox 47 and up, webdriver tests on Firefox need to use Mozilla's GeckoDriver.
Specify this option to choose which Geckodriver we should use. By default, we use the most recent version.

Test Name

string name
Add a name to this test, which will show up in our member area and API.

Screen Resolution

string screen-resolution
Possible values:
  • 800x600
  • 1024x768
  • 1152x864
  • 1280x768
  • 1280x800
  • 1280x960
  • 1280x1024
  • 1400x1050
  • 1600x1200
  • 1680x1050
  • 1920x1080
  • 1920x1200
  • 2560x1440
  • 2560x1600
Will adjust the screen resolution during your test.

Avoiding Proxy

boolean avoidProxy
By default we route all HTTP and HTTPs traffic with Selenium RC (Selenium 1) through a Selenium proxy, to make sure our browsers accept self-signed SSL certificates.
If you do not want this, use this option and set it to true.


string build
A key you can use to group certain tests in the same build (for example in Jenkins).
The builds will appear in our member area.

Custom data

string extra
Send along custom data, for example your release, server, commit hash, ...

Maximum test duration

int maxduration (seconds)
default: 1800
The maximum duration for a single test. This is a safeguard to prevent bad tests from using up your credits.

Idle timeout

int idletimeout (seconds)
default: 130
The maximum amount of time a browser will wait before proceeding to the next step in your test.

Test Privacy

boolean public
Default: false
Make the test results for this test public so that everyone can access the results.

Custom Time Zones

string timeZone
Change the Time Zone of the Virtual Machine to the Time Zone you specify. You can find a list of timezones on Wikipedia. Only location names are supported (not their paths). See some examples below:
"timeZone" : "Honolulu"
"timeZone" : "Lisbon"
"timeZone" : "Tasmania"

User extension

string user-extension
A URL pointing to your custom js extension.
We will load your custom user-extension with Selenium RC tests.
This is not supported with WebDriver tests.

Chrome/Firefox/Safari Extension

string load-extension
If you specify this desired capability with the URL to your Chrome extension's .crx file, the Firefox addon's .xpi file or Safari's .safariextz file, we will download the extension, which will be added to either Chrome, Firefox or Safari before your test starts.


string groups
comma seperated groups
Specify in which groups you want to see the test results. You can group results to have an easy overview of tests across projects.

Pre-run executables

string prerun (needs to be a valid URL)
(optional) string prerun-args "-d 1 -q 3"
When you specify a prerun file, we will first download the file and execute it (with optional prerun-arguments).
This is useful when you want to customize/add software before your test starts.

Upload file to VM

string upload
string uploadFilepath
When you specify an URL (upload) and fileName (uploadFilepath), we will automatically download the file from the URL and save it in the downloadFilepath.

Upload Multiple Files to VM

string uploadMultiple
array of objects, for example: [{ url: 'http://www.image.jpg', filePath: 'C:\test\image.jpg' }, { url: 'http://www.image2.jpg', filePath: 'C:\test\image2.jpg' }]
Specify an array of objects, containing keys 'url' and 'filePath'. We will automatically download these files and put them in the filePaths you specify.

We recommend using these directories to save your files: For Windows ("C:\test\"), for Linux/Mac: ("/tmp/").


string autoclick
array of options: chrome_extension_add, chrome_extension_permissions_allow
Specify one or more of the possible options below to have TestingBot automatically click certain dialogs which are unable to be automated via Selenium WebDriver.


string sikuli
string URL
Specify an URL to a zip-file containing one or more .sikulu projects. These will automatically start before your test runs, so that you can do certain automated tasks which Selenium cannot do (clicking native dialogs, ...)

Custom hostnames

array hosts
Example: hosts = [{ ip: '', domain: 'mydomain' }]
You can specify an array of objects containing the keys 'ip' and 'domain'. We will write these values to the hosts file of the VM.

Blacklist hostnames

string blacklist
Comma separated list of hosts you want to blacklist
The hostnames you specify will be pointed to localhost instead of their real destination. This means you can speed up tests by blocking third party content which you don't need and slows down your test.

Disable Logging

string recordLogs
Possible values: true, false, or strip-parameters
Default is we always log everything
Set to false if you don't want TestingBot to record anything (for example, if you have sensitive data).
You will not see any test logs in our member dashboard.
Set to strip-parameters to prevent the POST/GET parameters from being logged on TestingBot.