Fluent Wait

FluentWait is WebDriverWait with more knobs to turn. You can set the polling interval (how often it retries), which exceptions to ignore, and a custom error message. WebDriverWait actually extends FluentWait under the hood.

import org.openqa.selenium.support.ui.FluentWait;
import org.openqa.selenium.support.ui.Wait;

Wait<WebDriver> fluentWait = new FluentWait<>(driver)
    .withTimeout(Duration.ofSeconds(30))         // Max wait
    .pollingEvery(Duration.ofMillis(250))          // Check every 250ms
    .ignoring(NoSuchElementException.class)        // Ignore during polling
    .ignoring(StaleElementReferenceException.class) // Also ignore stale
    .withMessage("Timed out waiting for balance to load");

WebElement balance = fluentWait.until(d ->
    d.findElement(By.id("account-balance"))
);
System.out.println("Balance: " + balance.getText());

When to Use FluentWait Over WebDriverWait

• Elements re-render frequently → ignore StaleElementReferenceException
• Need faster polling (100ms for animations) or slower polling (2s for heavy operations)
• Want descriptive error messages for debugging: .withMessage("Waiting for payment confirmation")
• Waiting for non-element conditions like a JavaScript variable or URL pattern

For 95% of cases, WebDriverWait is enough. Use FluentWait when you need the extra control.