The Timing Problem

Selenium executes commands at machine speed — milliseconds. But web pages need time. An API call takes 1-2 seconds. An animation takes 300ms. JavaScript needs to render content. If Selenium tries to find an element before it exists, boom — NoSuchElementException.

// This test WILL fail intermittently
driver.findElement(By.id("login-btn")).click();

// Dashboard is still loading...
// but Selenium already tries to find this element
String balance = driver.findElement(
    By.id("account-balance")).getText();
// NoSuchElementException! Element doesn't exist yet.

Think of it like ordering food at a restaurant. You place the order and immediately try to eat. But the food isn't ready yet. You need to WAIT. The question is: how do you wait smartly?

The 4 Types of Waits