Mouse hover (moveToElement) in Selenium Java

Introduction

Mouse hover helps you test what happens when you move the mouse over an element without clicking. It shows hidden menus or tooltips.

To check if a dropdown menu appears when you hover over a menu item.

To verify tooltip text shows up when hovering on an icon.

To test if buttons change style or color on mouse hover.

To ensure hover-triggered popups or images appear correctly.

To simulate user behavior on interactive web elements.

Syntax

Selenium Java

Actions actions = new Actions(driver);
actions.moveToElement(WebElement element).perform();

Use Actions class to create complex user gestures like mouse hover.

Always call perform() to execute the action.

Examples

Hover over an element found by its ID 'menu'.

Selenium Java

WebElement menu = driver.findElement(By.id("menu"));
Actions actions = new Actions(driver);
actions.moveToElement(menu).perform();

Hover over an element with class 'info-icon' using a one-liner.

Selenium Java

WebElement icon = driver.findElement(By.cssSelector(".info-icon"));
new Actions(driver).moveToElement(icon).perform();

Hover over a button with text 'Submit' using XPath locator.

Selenium Java

WebElement button = driver.findElement(By.xpath("//button[text()='Submit']"));
Actions actions = new Actions(driver);
actions.moveToElement(button).perform();

Sample Program

This test opens a page, hovers over a menu item, and checks if the submenu appears. It prints PASS if visible, else FAIL.

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.interactions.Actions;

public class HoverTest {
    public static void main(String[] args) {
        System.setProperty("webdriver.chrome.driver", "path/to/chromedriver");
        WebDriver driver = new ChromeDriver();
        try {
            driver.get("https://www.example.com/menu");
            WebElement menu = driver.findElement(By.id("menu-item"));
            Actions actions = new Actions(driver);
            actions.moveToElement(menu).perform();
            // After hover, check if submenu is displayed
            WebElement submenu = driver.findElement(By.id("submenu-item"));
            if (submenu.isDisplayed()) {
                System.out.println("PASS: Submenu is visible on hover.");
            } else {
                System.out.println("FAIL: Submenu is not visible on hover.");
            }
        } finally {
            driver.quit();
        }
    }
}

Important Notes

Make sure the element is visible and interactable before hovering.

Hover may not work if the element is off-screen; scroll into view first if needed.

Use explicit waits to handle dynamic content after hover.

Summary

Mouse hover simulates moving the mouse pointer over an element.

Use Selenium's Actions class with moveToElement() and perform() methods.

It helps test UI changes triggered by hovering, like menus or tooltips.

Practice

1. What is the primary purpose of using moveToElement() in Selenium WebDriver?

easy

A. To scroll the page down

B. To click on a web element

C. To enter text into a text box

D. To simulate mouse hover over a web element

Solution

1. Step 1: Understand the function of moveToElement()

   The moveToElement() method is used to move the mouse pointer over a specific web element, simulating a hover action.

2. Step 2: Compare with other actions

   Clicking, scrolling, and typing are done by other methods like click(), scrollTo(), and sendKeys(). So, moveToElement() is specifically for hover.

3. Final Answer:

   To simulate mouse hover over a web element -> Option D

4. Quick Check:

   moveToElement() = mouse hover [OK]

Hint: moveToElement() always means mouse hover action [OK]

Common Mistakes:

• Confusing moveToElement() with click()
• Using moveToElement() to enter text
• Thinking moveToElement() scrolls the page

2. Which of the following is the correct syntax to perform a mouse hover on a WebElement named menu using Selenium Actions in Java?

easy

A. driver.moveToElement(menu).hover();

B. Actions.moveToElement(menu).perform();

C. new Actions(driver).moveToElement(menu).perform();

D. Actions(driver).hover(menu).perform();

Solution

1. Step 1: Recall the Actions class usage

   In Selenium Java, you create an Actions object with new Actions(driver), then chain moveToElement(element) and finish with perform().

2. Step 2: Check each option's syntax

   new Actions(driver).moveToElement(menu).perform(); correctly creates the Actions object and calls the methods. Options B, C, and D have incorrect method calls or missing object creation.

3. Final Answer:

   new Actions(driver).moveToElement(menu).perform(); -> Option C

4. Quick Check:

   Actions object + moveToElement + perform() = correct syntax [OK]

Hint: Always create Actions object before moveToElement() [OK]

Common Mistakes:

• Calling moveToElement() without Actions object
• Using driver.moveToElement() which is invalid
• Forgetting to call perform() at the end

3. Consider the following code snippet:

WebElement menu = driver.findElement(By.id("menu"));
Actions actions = new Actions(driver);
actions.moveToElement(menu).perform();
String tooltip = driver.findElement(By.id("tooltip")).getText();
System.out.println(tooltip);

What will be printed if the tooltip appears only after mouse hover?

medium

A. Empty string is printed

B. The tooltip text is printed

C. NoSuchElementException is thrown

D. StaleElementReferenceException is thrown

Solution

1. Step 1: Understand the hover effect

   The moveToElement(menu).perform() simulates mouse hover on the menu element, which triggers the tooltip to appear.

2. Step 2: Check tooltip retrieval

   After hover, the code finds the tooltip element by id and gets its text. Since the tooltip appears on hover, the text will be present and printed.

3. Final Answer:

   The tooltip text is printed -> Option B

4. Quick Check:

   Hover triggers tooltip, so text prints [OK]

Hint: Hover first, then get tooltip text to see it [OK]

Common Mistakes:

• Assuming tooltip is present before hover
• Not calling perform() after moveToElement()
• Expecting exceptions without missing elements

4. You wrote this code to hover over an element:

Actions actions = new Actions(driver);
actions.moveToElement(menu);

But the hover effect does not happen. What is the likely mistake?

medium

A. Missing perform() call after moveToElement()

B. Incorrect locator for menu element

C. Actions class cannot perform hover

D. Need to use click() instead of moveToElement()

Solution

1. Step 1: Check method chaining in Actions

   Actions methods like moveToElement() build the action but do not execute it until perform() is called.

2. Step 2: Identify missing perform()

   The code misses perform(), so the hover action is never executed.

3. Final Answer:

   Missing perform() call after moveToElement() -> Option A

4. Quick Check:

   Always end Actions with perform() [OK]

Hint: Always call perform() to execute Actions chain [OK]

Common Mistakes:

• Forgetting perform() after moveToElement()
• Assuming moveToElement() runs immediately
• Using click() when hover is needed

5. You want to hover over a menu item and then click a submenu item that appears only after hover. Which is the correct way to do this in Selenium Java?

hard

A. new Actions(driver).moveToElement(menu).click(submenu).perform();

B. menu.click(); submenu.click();

C. new Actions(driver).click(menu).click(submenu).perform();

D. driver.findElement(By.id("submenu")).click();

Solution

1. Step 1: Understand submenu visibility

   The submenu appears only after hovering over the menu, so we must hover first to reveal it.

2. Step 2: Use Actions to hover and click

   new Actions(driver).moveToElement(menu).click(submenu).perform(); chains moveToElement(menu) to hover, then click(submenu) to click the submenu, and finally perform() to execute both actions in order.

3. Step 3: Why other options fail

   menu.click(); submenu.click(); clicks menu without hover, so submenu may not appear. new Actions(driver).click(menu).click(submenu).perform(); clicks menu instead of hover. driver.findElement(By.id("submenu")).click(); clicks submenu directly without hover, likely causing failure.

4. Final Answer:

   new Actions(driver).moveToElement(menu).click(submenu).perform(); -> Option A

5. Quick Check:

   Hover then click submenu with Actions chain [OK]

Hint: Chain hover and click in Actions, then perform() [OK]

Common Mistakes:

• Clicking submenu before hover
• Using click() on menu instead of hover
• Not chaining actions before perform()