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.

Practice

1. Which Selenium method helps to check if an element is visible on the page?

easy

A. isEnabled()

B. isDisplayed()

C. getText()

D. click()

Solution

1. Step 1: Understand visibility check methods

   The isDisplayed() method returns true if the element is visible on the page.

2. Step 2: Compare other methods

   isEnabled() checks if element is enabled, getText() gets text, and click() performs click action, none check visibility.

3. Final Answer:

   isDisplayed() -> Option B

4. Quick Check:

   Visibility check = isDisplayed() [OK]

Hint: Use isDisplayed() to check visibility quickly [OK]

Common Mistakes:

• Confusing isEnabled() with visibility check
• Using getText() to check visibility
• Trying to click before checking visibility

2. Which of the following is the correct syntax to click a hidden element using JavaScript in Selenium Java?

easy

A. driver.javascriptExecutor.execute("arguments[0].click();", element);

B. driver.executeScript("arguments[0].click();", element);

C. JavascriptExecutor.executeScript("arguments[0].click();", element);

D. ((JavascriptExecutor)driver).executeScript("arguments[0].click();", element);

Solution

1. Step 1: Cast driver to JavascriptExecutor

   In Selenium Java, to run JavaScript, cast WebDriver to JavascriptExecutor: ((JavascriptExecutor)driver).

2. Step 2: Use executeScript method correctly

   Call executeScript with JavaScript code and element as argument: executeScript("arguments[0].click();", element);

3. Final Answer:

   ((JavascriptExecutor)driver).executeScript("arguments[0].click();", element); -> Option D

4. Quick Check:

   Correct JS click syntax = ((JavascriptExecutor)driver).executeScript("arguments[0].click();", element); [OK]

Hint: Cast driver to JavascriptExecutor before executeScript [OK]

Common Mistakes:

• Calling executeScript directly on driver without casting
• Using wrong method names like execute()
• Incorrect object references for JavascriptExecutor

3. What will be the output of the following code snippet if the element is hidden?

WebElement element = driver.findElement(By.id("hiddenBtn"));
boolean visible = element.isDisplayed();
System.out.println(visible);

medium

A. false

B. true

C. null

D. Throws NoSuchElementException

Solution

1. Step 1: Understand isDisplayed() behavior

   The isDisplayed() method returns false if the element exists but is hidden (not visible).

2. Step 2: Check element presence

   Since findElement finds the element by id, no exception is thrown. The element is hidden, so isDisplayed() returns false.

3. Final Answer:

   false -> Option A

4. Quick Check:

   Hidden element visibility = false [OK]

Hint: isDisplayed() returns false for hidden elements [OK]

Common Mistakes:

• Assuming isDisplayed() throws exception if element is hidden
• Confusing false with null
• Expecting true without checking visibility

4. Identify the error in this code snippet that tries to click a hidden element:

WebElement element = driver.findElement(By.id("hiddenBtn"));
element.click();

medium

A. No error, element.click() works on hidden elements

B. Throws NoSuchElementException because element is missing

C. Throws ElementNotVisibleException because element is hidden

D. Throws StaleElementReferenceException due to stale element

Solution

1. Step 1: Understand click behavior on hidden elements

   Trying to click a hidden element using element.click() causes ElementNotVisibleException because Selenium cannot interact with invisible elements.

2. Step 2: Check element presence

   The element is found, so no NoSuchElementException. It is not stale, so no StaleElementReferenceException.

3. Final Answer:

   Throws ElementNotVisibleException because element is hidden -> Option C

4. Quick Check:

   Click hidden element error = ElementNotVisibleException [OK]

Hint: Clicking hidden elements throws ElementNotVisibleException [OK]

Common Mistakes:

• Assuming click works on hidden elements
• Confusing NoSuchElementException with visibility issues
• Ignoring exception types for stale elements

5. You want to click a button that is hidden by default and only visible after scrolling. Which approach is best to handle this in Selenium Java?

hard

A. Use JavascriptExecutor to scroll element into view, then use element.click()

B. Directly call element.click() without scrolling

C. Use Thread.sleep() to wait and then click

D. Use Actions class to move to element and then click

Solution

1. Step 1: Scroll element into view using JavaScript

   Hidden elements due to scrolling can be made visible by scrolling them into view with JavascriptExecutor: executeScript("arguments[0].scrollIntoView(true);", element);

2. Step 2: Click the now visible element

   After scrolling, use element.click() to interact safely with the visible element.

3. Final Answer:

   Use JavascriptExecutor to scroll element into view, then use element.click() -> Option A

4. Quick Check:

   Scroll then click = JavascriptExecutor + click [OK]

Hint: Scroll element into view before clicking hidden buttons [OK]

Common Mistakes:

• Clicking without scrolling causes exceptions
• Using Thread.sleep() instead of scrolling
• Relying only on Actions class without scrolling