top of page
90s theme grid background
Writer's pictureGunashree RS
Sep 107 min read

Guide to ChromeDriver Versions: Setup & Best Practices

Introduction to ChromeDriver Versions

In the world of web testing, ChromeDriver plays an essential role in enabling automation on Google Chrome browsers. It acts as a bridge between the Selenium WebDriver framework and the Chrome browser, allowing testers to automate interactions like clicking buttons, filling out forms, and navigating web pages. However, the ChromeDriver needs to be compatible with the version of the Chrome browser you’re testing on, making it essential to select the correct ChromeDriver version. Failing to match the ChromeDriver and Chrome browser versions can result in errors and incomplete test runs.


This comprehensive guide will walk you through everything you need to know about ChromeDriver versions: how to download, configure, and run Selenium tests on real and virtual Chrome browsers. We’ll also cover best practices for using ChromeDriver efficiently, ensuring smooth test automation processes.


ChromeDriver Versions

What is ChromeDriver?

ChromeDriver is a separate executable or server designed to communicate with Google Chrome browsers through Selenium WebDriver. It allows developers and testers to automate their interactions with a website by simulating user actions such as clicking, typing, scrolling, and navigation. Without ChromeDriver, automating tests on the Chrome browser using Selenium would be impossible.


Key Features of ChromeDriver:

  • Controls Google Chrome browser sessions via Selenium WebDriver.

  • Supports a headless mode for running tests without opening the browser window.

  • Works with multiple Chrome versions, but requires a matching ChromeDriver version for compatibility.

  • Cross-platform compatibility, supporting Windows, macOS, and Linux operating systems.


Why ChromeDriver Version is Important

The relationship between the Chrome browser and ChromeDriver version is crucial because each ChromeDriver version is tied to a specific Chrome browser release. If you try to run a test using a mismatched ChromeDriver version (e.g., using a ChromeDriver built for version 115 of Chrome with version 114 of Chrome), your tests will likely fail. The incompatibility may cause communication issues between Selenium WebDriver and the Chrome browser, leading to broken test execution.


To avoid these problems, always make sure that:

  • The ChromeDriver version matches the Chrome browser version.

  • If using Chrome’s auto-updating feature, ensure ChromeDriver is regularly updated.


How to Download ChromeDriver for Selenium

ChromeDriver can be downloaded from its official site, and different versions are available depending on the Chrome browser version installed on your system. Follow these steps to download the correct ChromeDriver version:


Steps to Download ChromeDriver Version 115 and Above

  1. Visit ChromeDriver Official Site:Go to the ChromeDriver official download page.

  2. Navigate to Chrome for the Testing Availability Dashboard:For Chrome browser version 115 and above, you’ll need to navigate to the Chrome for Testing availability dashboard, which lists Stable, Beta, Dev, and Canary releases for Chrome.

  3. Select the Appropriate ChromeDriver Version:Choose the Stable release corresponding to your Chrome browser version. Download the ChromeDriver Win32 or Win64 based on your system’s architecture.

  4. Download and Extract:Download the ChromeDriver in .zip format and extract it to a folder of your choice.


Steps to Download ChromeDriver Version 114 and Below

  1. Visit ChromeDriver Official Site:Navigate to the ChromeDriver official page which lists all versions of ChromeDriver.

  2. Select Your ChromeDriver Version:Based on your Chrome browser version (e.g., Chrome 114), download the respective ChromeDriver version. For example, if using Chrome version 114, download ChromeDriver 114.0.5735.90.

  3. Download for Your Operating System:Click on chromedriver_win32.zip for Windows or select the corresponding file for macOS or Linux.

  4. Extract the Zip File:After downloading, extract the contents and move them to your desired directory.


How to Configure ChromeDriver

Once you’ve downloaded the appropriate ChromeDriver version, the next step is to configure it so Selenium can locate it during test execution. You can configure ChromeDriver in two ways: by setting an environment variable or by specifying the path using the System.setProperty method.


1. Configure ChromeDriver via Environment Variable

Using environment variables is the easiest way to ensure that Selenium automatically detects ChromeDriver whenever you initialize WebDriver in your scripts.


Steps to Configure ChromeDriver via Environment Variable (Windows):

  1. Copy the path where your ChromeDriver executable is stored.

  2. Open System Properties by searching for "Environment Variables" in the Windows search bar.

  3. Click the Environment Variables button and select the Path variable under System Variables.

  4. Click Edit, then add a new entry for the ChromeDriver path.

  5. Click OK to save the changes. Now, when Selenium calls ChromeDriver, it will automatically detect the executable from the system’s environment variables.


2. Configure ChromeDriver via System.setProperty Method

Alternatively, you can configure ChromeDriver directly in your Selenium test scripts using the System.setProperty method. This method explicitly defines the ChromeDriver location in the script.


Code Example:

java

System.setProperty("webdriver.chrome.driver", "D:\\path_to_chromedriver\\chromedriver.exe");
WebDriver driver = new ChromeDriver();

This command sets the ChromeDriver path explicitly, making it easier to change drivers if needed for different versions of Chrome.


For macOS Users:

  • Open the terminal and type the command:

bash

sudo nano /etc/paths

  • Enter your password.

  • Add the path of your ChromeDriver to the file.

  • Press Y to save the changes.

  • Exit by pressing Control + C.


Steps to Run Selenium Tests on Chrome Browser

Now that you’ve configured ChromeDriver, it’s time to run a basic Selenium test. Here’s a step-by-step guide:


Set Up a New Java Project:Create a new project in your preferred IDE (e.g., Eclipse) and add the Selenium WebDriver libraries to the build path.


Initialize ChromeDriver:In your code, initialize ChromeDriver by setting the property as shown above. If you’ve configured ChromeDriver through environment variables, omit the System.setProperty line.


Write and Run the Test:Here’s a basic script to open a website and validate the page title:

java

Import org.openqa.selenium.WebDriver;
import org.openqa.selenium.chrome.ChromeDriver;

public class ChromeTest {
    public static void main(String[] args) {
        WebDriver driver = new ChromeDriver();
        driver.get("https://www.bstackdemo.com");
        System.out.println("Page title is: " + driver.getTitle());
        dr