Options Selenium screen

This screen allows you to setup the requirements of some of the WebDrivers.

Configuration Options

WebDrivers

Field	Details	Default	Config File
ChromeDriver	This allows you to select the location of ChromeDriver.	The path to the bundled WebDriver, if available.	Key: `selenium.chromeDriver` Value: file system path to the ChromeDriver
geckodriver	This allows you to select the location of geckodriver (Firefox driver).	The path to the bundled WebDriver, if available.	Key: `selenium.firefoxDriver` Value: file system path to the geckodriver

Binaries

Field	Details	Default	Config File
Chrome	This allows you to select the location of Chrome binary (for example, to use a version other than the system default).	(None)	Key: `selenium.chromeBinary` Value: file system path to the Chrome binary
Firefox	This allows you to select the location of Firefox binary (for example, to use a version other than the system default).	(None)	Key: `selenium.firefoxBinary` Value: file system path to the Firefox binary

Note: It’s also possible to set the above locations (binaries and WebDrivers) using Java system properties, in which case the above options will be overridden and those values shown instead.

More details about the bundled WebDrivers can be found on the overview page.

Browser Arguments

Both Chrome and Firefox binaries can have additional (CLI) arguments specified through the Arguments... button.

Note: Adding invalid arguments might cause the browser to fail to start. ZAP already adds some arguments (e.g. headless).

Browser Profiles

You can choose which Firefox profile to use by default. The <temporary> profile is one which is created by Selenium each time the browser is launched.

Note: The ‘client’ add-on creates a profile called zap-client-profile - if you choose another profile then the Client add-on will not work without manual configuration.

Browser Extensions

You can add, remove, enable, or disable browser extensions via the relevant buttons on this screen. Supported browsers and file extensions are:

Firefox: .xpi
Chrome: .crx

Add-ons can also add new browser extensions. If you delete a browser extension via this screen then it will be added again by the add-on so either just disable it or uninstall the add-on to remove the browser extension.


	Selenium	for an overview of the Selenium add-on
	API	for an overview of the Selenium API