Web Driver Management
Automatic Web Driver Management
As of gwen-web v2.34.0, Gwen uses the following embedded web driver manager to automatically download and manage native web driver binaries for you:
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.
Custom Manager Settings and Configuration
If you wish to have more control over driver versions or other aspects of this process, you can configure explicit wdm.*
configuration options in your Gwen settings file. See the WebDriverManager documentation for information about these options.
For example, to have the manager download a specific version of a chrome driver:
- .conf
- .json
- .properties
wdm {
chromeDriverVersion = "<your desired chrome driver version>"
}
{
"wdm": {
"chromeDriverVersion": "<your desired chrome driver version>"
}
}
wdm.chromeDriverVersion = <your desired chrome driver version>
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