Handling hidden elements in Selenium Java

Introduction

Sometimes web elements are hidden and not visible on the page. We need to handle them carefully to avoid test failures.

When a button is present in the HTML but not visible until a user action.

When a dropdown menu is hidden and appears only after clicking another element.

When testing if hidden elements exist but should not be interacted with directly.

When verifying that certain elements are hidden for security or design reasons.

Syntax

Selenium Java

WebElement element = driver.findElement(By.id("elementId"));
boolean isDisplayed = element.isDisplayed();

isDisplayed() checks if the element is visible on the page.

Hidden elements exist in the DOM but return false for isDisplayed().

Examples

This checks if the element with id 'hiddenElement' is visible or hidden.

Selenium Java

WebElement hiddenElement = driver.findElement(By.id("hiddenElement"));
boolean visible = hiddenElement.isDisplayed();

Use this to avoid clicking on hidden elements which would cause errors.

Selenium Java

if (!hiddenElement.isDisplayed()) {
    System.out.println("Element is hidden, cannot click.");
}

Use JavaScript to click hidden elements if needed, but use carefully.

Selenium Java

JavascriptExecutor js = (JavascriptExecutor) driver;
js.executeScript("arguments[0].click();", hiddenElement);

Sample Program

This test opens a page, finds a button that might be hidden, checks if it is visible, and clicks it normally if visible. If hidden, it clicks using JavaScript to avoid errors.

Selenium Java

import org.openqa.selenium.By;
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.WebElement;
import org.openqa.selenium.chrome.ChromeDriver;
import org.openqa.selenium.JavascriptExecutor;

public class HiddenElementTest {
    public static void main(String[] args) {
        System.setProperty("webdriver.chrome.driver", "path/to/chromedriver");
        WebDriver driver = new ChromeDriver();
        try {
            driver.get("https://example.com/hidden-element-page");

            WebElement hiddenButton = driver.findElement(By.id("hiddenButton"));

            if (hiddenButton.isDisplayed()) {
                hiddenButton.click();
                System.out.println("Clicked the visible button.");
            } else {
                System.out.println("Button is hidden, clicking with JavaScript.");
                JavascriptExecutor js = (JavascriptExecutor) driver;
                js.executeScript("arguments[0].click();", hiddenButton);
                System.out.println("Clicked the hidden button via JavaScript.");
            }
        } finally {
            driver.quit();
        }
    }
}

Important Notes

Always prefer normal clicks over JavaScript clicks for better test reliability.

Hidden elements can cause exceptions if you try to interact with them directly.

Use isDisplayed() to check visibility before actions.

Summary

Hidden elements exist in the page but are not visible.

Use isDisplayed() to check if an element is visible.

Use JavaScript clicks only if normal clicks fail due to hidden elements.