Skip to main content

Upgrade or Downgrade WebDrivers in Katalon Studio

To have a better control of the browser versions while testing, Katalon Studio allows you to update or downgrade WebDrivers manually or via Katalon Studio built-in tools. This article will show you how to do so.

Update a WebDriver

You can update Chrome, Firefox, Edge Chromium and Internet Explorer WebDrivers directly from Katalon Studio.

From the main toolbar, select Tools > Update WebDrivers. Select a browser in the dropdown list.

Katalon Studio can detect and allows you to auto-update a compatible Chrome or Edge Chromium driver version when start using Spy/Recorder Web Utility.

update-webdriver-automatically

For console mode execution, you can use this command argument --config -webui.autoUpdateDrivers=true to allow automatic WebDriver updates. You can learn more about using the console mode here: Console Mode Execution.

Replace a Webdriver

To upgrade or downgrade WebDrivers, you can replace WebDrivers manually. You can choose to do so at the application or project level.

notes

By default, Katalon Studio runs WebDrivers at the application level. Adding a Webdriver at the project level overrides the application level to open your web browsers.

Do as follows:

  1. Find the WebDriver version you want to run your test with. You can find them here:
  2. Find the location of the WebDrivers you want to replace.
  • At the application level, WebDriver binaries are stored here:

    Note: If you have multiple Katalon Studio versions installed on your development machine, make sure to navigate to the correct path of the Katalon Studio version you wish to use.

    For Window users
    Chrome
    (You can use 32-bit Windows Chromedriver for both 32-bit and 64-bit Windows)
    <Katalon Studio folder>\configuration\resources\drivers\chromedriver_win32

    <Katalon Studio folder>\configuration\resources\drivers\chromedriver_win64
    Firefox<Katalon Studio folder>\\configuration\\resources\\drivers\\firefox_win32

    <Katalon Studio folder>\\configuration\\resources\\drivers\\firefox_win64
    Internet Explorer<Katalon Studio folder>\configuration\resources\drivers\iedriver_win32

    <Katalon Studio folder>\configuration\resources\drivers\iedriver_win64
    Edge<Katalon Studio folder>\configuration\resources\drivers\edgedriver
    Edge (Chromium)<Katalon Studio folder>\configuration\resources\drivers\edgechromium_win32

    <Katalon Studio folder>\configuration\resources\drivers\edgechromium_win64

    For macOS users
    Chrome/Applications/Katalon Studio.app/Contents/Eclipse/configuration/resources/drivers/chromedriver_mac
    Firefox/Applications/Katalon Studio.app/Contents/Eclipse/configuration/resources/drivers/firefox_mac
    Edge (Chromium)/Applications/Katalon Studio.app/Contents/Eclipse/configuration\resources\drivers\edgechromium_mac
  • At the project level, go to \Project Folder\Include on your computer and follow the below paths:ChromeFirefoxEdge (Chromium)ChromeFirefoxChromeFirefox

    By default, there is no Webdriver at project level. After replacing WebDrivers at project level, restart Katalon Studio to run new WebDrivers.

    For Window users
    ChromeInclude/drivers/chromedriver_win32/chromedriver.exe

    Include/drivers/chromedriver_win64/chromedriver.exe
    FirefoxInclude/drivers/geckodriver_win32/geckodriver.exe

    Include/drivers/geckodriver_win64/geckodriver.exe
    Internet ExplorerInclude/drivers/iedriver_win32/IEDriverServer.exe

    Include/drivers/iedriver_win64/IEDriverServer.exe
    Edge (Chromium)Include/drivers/edgedriver_win32/MicrosoftWebDriver.exe

    Include/drivers/edgedriver_win64/MicrosoftWebDriver.exe

    Include/drivers/edgechromiumdriver_win64/msedgedriver.exe

    Include/drivers/edgechromiumdriver_win32/msedgedriver.exe

    For macOS users
    ChromeInclude/drivers/chromedriver_mac64/chromedriver
    FirefoxInclude/drivers/geckodriver_mac64/geckodriver
    Edge (Chromium)Include/drivers/edgechromiumdriver_mac/msedgedriver

    For Linux users
    ChromeInclude/drivers/chromedriver_linux32/chromedriver

    Include/drivers/chromedriver_linux64/chromedriver
    FirefoxInclude/drivers/geckodriver_linux32/geckodriver

    Include/drivers/geckodriver_linux64/geckodriver
  1. After finding the correct location, replace the driver.exe file with the one you have downloaded.Note: After updating or downgrading WebDrivers, to make sure the current version of the browser driver is running smoothly, it is advisable to try re-running the test to resolve and check any pop-up issues.

Use DriverFactory library

Katalon Studio also offers DriverFactory library to manipulate WebDriver instances by using Katalon keywords.

Note:
  • Starting from Katalon Studio version 10.0.0, the DriverFactory class has been refactored. If you are using methods like getChromeDriverPath(), refer to the migration documentation for details on these changes and how to update your scripts: Refactoring of DriverFactory.

See also

Was this page helpful?