HelpAddonsSeleniumIntro

Selenium

The Selenium add-on provides WebDrivers, for other add-ons, to invoke and remotely control web browsers. It's also bundled the HtmlUnit web browser, an headless Java based web browser.

The following web browsers are supported:

• Chrome
• Firefox - the following versions are known to work: 45 (ESR), 46 and 47.0.1 (older version might work too). Some versions do not work correctly: 47.0 and 48+.
• HtmlUnit
• Internet Explorer
• Opera
• PhantomJS
• Safari

To use Firefox, Chrome, Internet Explorer, Opera, PhantomJS and Safari, you must have them installed in your system.

Some of the web browsers require extra configurations, done in Options Selenium screen, to access and control them:

• Chrome - requires ChromeDriver, if not on the system's PATH, it can be set in the options. For more information on ChromeDriver and how to obtain it refer to ChromeDriver website.
• PhantomJS - requires PhantomJS binary, if not on the system's PATH, it can be set in the options. For more information on PhantomJS and how to obtain it refer to PhantomJS website (see footer note for caveat when using PhantomJS).
• Internet Explorer - requires IEDriverServer, if not on the system's PATH, it can be set in the options. For more information on IEDriverServer refer to IEDriverServer website (see footer note for caveat when using Internet Explorer).

PhantomJS Note: There's an issue (Issue #11342) that prevents sites at localhost, 127.0.0.1 and ::1 from being proxied through ZAP. Until a fix is available is advised to not use it in those cases. Some add-ons might choose to show warning message when that happens.

Internet Explorer Note: Not all versions of Internet Explorer work out of the box, refer to IEDriverServer website for more details on how to configure them.

See also

	Options Selenium screen	for an overview of the Selenium Options
	API	for an overview of the Selenium API