Upgrade 500 Selenium v3 tests to Selenium v4, Easy!

Zhimin Zhan
3 min readMar 21, 2021

Selenium WebDriver Beta1 was released last month. I usually waited for the second Beta version, and the ruby releases are shown below.

To upgrade the test execution environment to use Selenium v4 is easy, just run the following command.

> gem install selenium-webdriver --version 4.0.0.beta2

In fact, that’s what I needed to do for upgrading the WhenWise regression suite. This is the beauty of WebDriver being W3C compliant.

Here are the steps I took to ensure that the WhenWise regression test suite works fine with Selenium v4.

  1. Upgrade Selenium on the CT server, and trigger a run of all the Selenium WebDriver recipes (196 of them, from the book) on the BuildWise server, as a general check.

There was one error on the syntax change of start Firefox with a custom profile; only minor change is required. All WhenWise tests are set to run in Chrome, so no update is required.

2. Upgrade Selenium on my local machine, and run a few tests in the functional testing IDE (TestWise).

This step is optional. I want to make sure the tool is capable of debugging Selenium v4 tests, being prepared to cope with test failures, if any, detected in the Continuous Testing process. It turned out I do need a minor update to TestWise to support the syntax with the introduction of relative locators. The latest TestWise 6.3 now supports Selenium v4.

3. Update Selenium on 9 build agents and trigger a CT build on the BuildWise CT server.

All tests (500 in the WhenWise regression suite) passed, a green build! Done.


Selenium WebDriver v4 is reliable for production use, and the upgrade is straightforward.

It has been 4.5 years since Selenium 3 Beta, and people would assume a considerable effort for upgrading a large test suite…



Zhimin Zhan

Test automation & CT coach, author, speaker and award-winning software developer. Help teams succeed with Agile/DevOps by implementing real Continuous Testing.