Selenium WebDriver Complete Guide 2026

Last updated 2026-07-20 · 18 min read · By Avinash K

Selenium is still the most-installed test tool on Earth in 2026, powering the majority of enterprise regression suites. Selenium 4 modernized the API — relative locators, native BiDi protocol, container-first Grid — while keeping backward compatibility. This guide gets you productive fast.

// Maven
<dependency>
  <groupId>org.seleniumhq.selenium</groupId>
  <artifactId>selenium-java</artifactId>
  <version>4.24.0</version>
</dependency>

WebDriver driver = new ChromeDriver();
driver.get("https://softwaretestpilot.com");
driver.findElement(By.linkText("Jobs")).click();
driver.quit();

Selenium Manager (built-in since 4.11) auto-downloads the right driver binary — no more WebDriverManager for most cases.

// Classic
driver.findElement(By.id("email"));
driver.findElement(By.cssSelector("button[data-testid='submit']"));

// Selenium 4 — relative locators
import static org.openqa.selenium.support.locators.RelativeLocator.with;
WebElement password = driver.findElement(with(By.tagName("input")).below(By.id("email")));

// ✅ Explicit wait
new WebDriverWait(driver, Duration.ofSeconds(10))
  .until(ExpectedConditions.elementToBeClickable(By.id("submit")));

// ❌ Never
Thread.sleep(3000);

• BiDi protocol — subscribe to console logs, network events, JS errors.
• Relative locators — above, below, toLeftOf, toRightOf, near.
• New Grid 4 — Docker-first, observable via OpenTelemetry.
• Chrome DevTools Protocol — throttle network, emulate geolocation.

The official Selenium WebDriver docs stay the canonical reference.

Reference structure:

src/test/java/
  pages/       ← Page Objects
  tests/       ← @Test classes
  base/        ← BaseTest with driver setup
  utils/       ← waits, data helpers
testng.xml

Deeper: Java for Selenium.

docker network create grid
docker run -d --net grid --name selenium-hub selenium/hub:4.24
docker run -d --net grid -e SE_EVENT_BUS_HOST=selenium-hub \
  -e SE_EVENT_BUS_PUBLISH_PORT=4442 -e SE_EVENT_BUS_SUBSCRIBE_PORT=4443 \
  selenium/node-chrome:4.24

Point your driver at http://localhost:4444/wd/hub. Scale nodes horizontally as you add parallel tests.

Run Grid as a service container, execute your Maven Surefire suite, publish Allure or ExtentReports as artifacts. See GitHub Actions + Selenium CI.