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 Selenium's embedded driver manager (introduced in Selenium v4.6.0) 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.

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)
  • Chrome
  • Firefox
  • IE
  • Edge (supported since gwen-web v2.35.0)
• 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

Linux

webdriver {
  gecko {
    driver = "/path/to/geckodriver"
  }
  chrome {
    driver = "/path/to/chromedriver"
  }
}

Windows

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"
  }
}

.json

Linux

{
  "webdriver": {
    "gecko": {
      "driver": "/path/to/geckodriver"
    },
    "chrome": {
      "driver": "/path/to/chromedriver"
    }
  }
}

Windows

{
  "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"
    }
  }
}

.properties

Linux

webdriver.gecko.driver  = /path/to/geckodriver
webdriver.chrome.driver = /path/to/chromedriver

Windows

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