Web Driver Management
Automatic Web Driver Management
Since v2.34.0
- Gwen uses the following embedded web driver manager to automatically download and manage native web driver binaries for you: WebDriverManager
Since v3.32.0
- Gwen uses SeleniumManager (introduced in Selenium v4.6.0) to automatically download and manage native web driver binaries for you
Since v3.34.0
- Gwen enables you to switch between SeleniumManager (default) and WebDriverManager with the
gwen.web.driver.manager
setting
Automatic web driver management will only be active if no webdriver.xx.driver
properties are set. So if you are upgrading from an older version of Gwen, be sure to remove these from your Gwen settings files if you wish for Gwen to manage native drivers for you.
The embedded manager will auto-detect your current browser version and download and configure the latest web driver binary that is compatible with that browser. So you don't need to do a thing.
Proxy Configuration
If you are behind a proxy, you will need to set the HTTPS_PROXY
variable in your environment.
Manual Web Driver Management
Perform the following if you are using a gwen-web version prior to v2.34.0 or if you would prefer to manage native drivers yourself:
Download and install the native web driver you want
- Click the link to download the driver binary for your target browser (download the latest one or the version that you wish)
- Unpack the binary to a location on your drive
Point Gwen to your installed web driver
Once you've install the native driver using one of the methods above, set the path to it in your Gwen settings file with one of the browser specific settings below (depending on your browser and platform):
- conf
- json
- properties
- Linux
- Windows
webdriver {
gecko {
driver = "/path/to/geckodriver"
}
chrome {
driver = "/path/to/chromedriver"
}
}
webdriver {
gecko {
driver = "c:/path/to/geckodriver.exe"
}
chrome {
driver = "c:/path/to/chromedriver.exe"
}
edge {
driver = "c:/path/to/msedgedriver"
}
ie {
driver = "c:/path/to/IEDriverServer.exe"
}
}
- Linux
- Windows
{
"webdriver": {
"gecko": {
"driver": "/path/to/geckodriver"
},
"chrome": {
"driver": "/path/to/chromedriver"
}
}
}
{
"webdriver": {
"gecko": {
"driver": "c:/path/to/geckodriver.exe"
},
"chrome": {
"driver": "c:/path/to/chromedriver.exe"
},
"edge": {
"driver": "c:/path/to/msedgedriver"
},
"ie": {
"driver": "c:/path/to/IEDriverServer.exe"
}
}
}
- Linux
- Windows
webdriver.gecko.driver = /path/to/geckodriver
webdriver.chrome.driver = /path/to/chromedriver
webdriver.gecko.driver = c:/path/to/geckodriver.exe
webdriver.chrome.driver = c:/path/to/chromedriver.exe
webdriver.edge.driver = c:/path/to/msedgedriver
webdriver.ie.driver = c:/path/to/IEDriverServer.exe