Legacy Selenium Desired Capabilities
These capabilities worked with the legacy JSON Wire Protocol
This documentation previously located on the wiki
See JSON Wire Protocol for common capabilities.
Remote Driver Specific
| Key | Type | Description |
| webdriver.remote.sessionid | string | WebDriver session ID for the session. Readonly and only returned if the server implements a server-side webdriver-backed selenium. |
| webdriver.remote.quietExceptions | boolean | Disable automatic screnshot capture on exceptions. This is False by default. |
Grid Specific
| Key | Type | Description |
| path | string | Path to route request to, or maybe listen on. |
| seleniumProtocol | string | Which protocol to use. Accepted values: WebDriver, Selenium. |
| maxInstances | integer | Maximum number of instances to allow to connect to grid |
| environment | string | Possible duplicate of browserName? See RegistrationRequest |
Selenium RC Specific
| Key |
Type |
Description |
| proxy_pac |
boolean |
Legacy proxy mechanism. Do not use. |
| commandLineFlags |
string |
Flags to pass to browser command line. |
| executablePath |
string |
Path to browser executable. |
| timeoutInSeconds |
long integer |
Timeout to wait for the browser to launch, in seconds. |
| onlyProxySeleniumTraffic |
boolean |
Whether to only proxy selenium traffic. See browserlaunchers.Proxies |
| avoidProxy |
boolean |
??? See browserlaunchers.Proxies |
| proxyEverything |
boolean |
??? See browserlaunchers.Proxies |
| proxyRequired |
boolean |
??? See browserlaunchers.Proxies |
| browserSideLog |
boolean |
??? See AbstractBrowserLauncher. |
| optionsSet |
boolean |
??? See BrowserOptions. |
| singleWindow |
boolean |
Whether to enable single window mode. |
| dontInjectRegex |
javascript RegExp |
Regular expression that proxy injection mode can use to know when to bypss injection. Ignored if not in proxy injection mode. |
| userJSInjection |
boolean |
??? Whether to inject user JS. Ignored if not in proxy injection mode. |
| userExtensions |
string |
Path to a JavaScript file that will be loaded into selenium. |
Selenese-Backed-WebDriver specific
| Key |
Type |
Description |
| selenium.server.url |
string |
URL of Selenium server to use, to back this WebDriver |
Firefox specific
| Key |
Type |
Description |
| captureNetworkTraffic |
boolean |
Whether to capture network traffic. |
| addCustomRequestHeaders |
boolean |
Whether to add custom request headers. |
| trustAllSSLCertificates |
boolean |
Whether to trust all SSL certificates. |
| changeMaxConnections |
boolean |
??? See FirefoxChromeLauncher. |
| firefoxProfileTemplate |
string |
??? See FirefoxChromeLauncher. |
| profile |
string |
??? See FirefoxChromeLauncher |
FirefoxProfile settings
Preferences accepted by the FirefoxProfile with special meaning, in the WebDriver API:
| Key |
Type |
Description |
| webdriver_accept_untrusted_certs |
boolean |
Whether to trust all SSL certificates. TODO: Maybe in some way different to the acceptSslCerts or trustAllSSLCertificates capabilities. |
| webdriver_assume_untrusted_issuer |
boolean |
Whether to trust all SSL certificate issuers. TODO: Maybe in some way different to the acceptSslCerts or trustAllSSLCertificates capabilities. |
| webdriver.log.driver |
string |
Level at which to log FirefoxDriver logging statements to a temporary file, so that they can be retrieved by a getLogs command. Available options; DEBUG, INFO, WARNING, ERROR, OFF. Defaults to OFF. |
| webdriver.log.file |
string |
Path to file to which to copy firefoxdriver logging output. Defaults to no file (like /dev/null). |
| webdriver.load.strategy |
string |
Experimental API. Defines different strategies for how long to wait until a page is loaded. Values: unstable, conservative. Defaults to conservative. |
| webdriver_firefox_port |
integer |
Port to listen on for WebDriver commands. Defaults to 7055. |
IE specific
| Key |
Type |
Description |
| killProcessesByName |
boolean |
Whether to try to kill processes by name, instead (or addition) to killing processes we happen to have handles to. |
| honorSystemProxy |
boolean |
Whether to honor the system proxy. |
| ensureCleanSession |
boolean |
Whether to make sure the session has no cookies or temporary internet files on Windows. I believe this is passed to the IEDriver as well, but ignored by it. |
Safari specific
| Key |
Type |
Description |
| honorSystemProxy |
boolean |
Whether to honour the sysem proxy. |
| ensureCleanSession |
boolean |
Whether to make sure the session has no cookies, cache entries. And that any registry and proxy settings are restored after the session. |
