Action chain execution (perform) in Selenium Java

Introduction

Action chains let you do several mouse or keyboard steps in order, like clicking and dragging. You use perform() to actually run these steps.

You want to hover over a menu to see a dropdown.

You need to drag and drop an item on a webpage.

You want to right-click on an element to open a context menu.

You want to type keys with pauses or special keys like SHIFT.

You want to combine multiple actions like click, hold, move, and release.

Syntax

Selenium Java

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

perform() runs all the actions you added in order.

You must call perform() at the end to execute the chain.

Examples

This moves the mouse over the menu element to trigger hover effects.

Selenium Java

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

This drags an element from source to target and releases it.

Selenium Java

Actions actions = new Actions(driver);
actions.clickAndHold(source).moveToElement(target).release().perform();

This right-clicks on the element to open the context menu.

Selenium Java

Actions actions = new Actions(driver);
actions.contextClick(element).perform();

Sample Program

This test opens a webpage, finds a menu element, moves the mouse over it using an action chain, and prints a success message.

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 ActionChainExample {
    public static void main(String[] args) {
        System.setProperty("webdriver.chrome.driver", "path/to/chromedriver");
        WebDriver driver = new ChromeDriver();
        try {
            driver.get("https://example.com/menu");
            WebElement menu = driver.findElement(By.id("menu"));

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

            System.out.println("Hover action performed successfully.");
        } finally {
            driver.quit();
        }
    }
}

Important Notes

Always call perform() to run the actions; without it, nothing happens.

Chain multiple actions before perform() to do complex steps smoothly.

Use explicit waits if elements appear after hover or other actions.

Summary

Action chains let you combine mouse and keyboard steps.

perform() runs all the steps you added.

Use action chains for hover, drag-drop, right-click, and more.

Practice

1. What does the perform() method do in Selenium's Action Chains?

easy

A. It pauses the execution of the action chain.

B. It initializes the action chain object.

C. It clears all the actions added to the chain.

D. It executes all the actions added to the chain in order.

Solution

1. Step 1: Understand the role of perform()

   The perform() method triggers the execution of all the actions queued in the action chain.

2. Step 2: Differentiate from other methods

   Other methods like build() prepare the chain, but perform() actually runs it.

3. Final Answer:

   It executes all the actions added to the chain in order. -> Option D

4. Quick Check:

   perform() runs actions [OK]

Hint: Remember: perform() means 'do it now' [OK]

Common Mistakes:

• Confusing perform() with build()
• Thinking perform() initializes the chain
• Assuming perform() clears actions

2. Which of the following is the correct way to execute an action chain in Selenium Java?

easy

A. actions.click(element).perform();

B. actions.run().click(element);

C. actions.click(element).execute();

D. actions.perform().click(element);

Solution

1. Step 1: Review correct method chaining syntax

   In Selenium Java, you add actions like click(element) and then call perform() to execute.

2. Step 2: Identify the correct method names

   perform() is the method to run the chain; execute() and run() do not exist.

3. Final Answer:

   actions.click(element).perform(); -> Option A

4. Quick Check:

   Action then perform() [OK]

Hint: Chain actions first, then call perform() [OK]

Common Mistakes:

• Calling perform() before adding actions
• Using non-existent methods like execute()
• Incorrect method order

3. What will happen when the following code runs?

Actions actions = new Actions(driver);
actions.moveToElement(menu).click(subMenu).perform();

medium

A. The mouse clicks 'menu' element and then moves to 'subMenu' element.

B. The mouse moves to 'menu' element and clicks on 'subMenu' element.

C. Only the 'menu' element is clicked.

D. The code throws a syntax error.

Solution

1. Step 1: Analyze the action chain sequence

   The code first moves the mouse to the 'menu' element, then clicks on the 'subMenu' element.

2. Step 2: Understand method chaining effect

   Actions are executed in order: moveToElement, then click, then perform runs them.

3. Final Answer:

   The mouse moves to 'menu' element and clicks on 'subMenu' element. -> Option B

4. Quick Check:

   moveToElement then click then perform [OK]

Hint: Actions run in order added, perform() executes all [OK]

Common Mistakes:

• Assuming click happens before moveToElement
• Thinking only one element is affected
• Believing code has syntax errors

4. Identify the error in this Selenium Java code snippet:

Actions actions = new Actions(driver);
actions.click(element);
actions.perform();

medium

A. The perform() method is called on a new Actions object, not the one with click.

B. The click() method must be followed immediately by perform() in the same statement.

C. There is no error; the code will work as expected.

D. The actions object is not properly initialized.

Solution

1. Step 1: Check method chaining and object usage

   The code adds a click action, then calls perform() on the same actions object, which is valid.

2. Step 2: Confirm no syntax or logical errors

   Calling perform() separately after adding actions is allowed and executes the chain.

3. Final Answer:

   There is no error; the code will work as expected. -> Option C

4. Quick Check:

   Separate perform() call is valid [OK]

Hint: perform() can be called separately after adding actions [OK]

Common Mistakes:

• Thinking perform() must be chained immediately
• Assuming new Actions object needed for perform()
• Believing code has syntax errors

5. You want to hover over a menu, then right-click a submenu, and finally double-click an option using Selenium Java Actions. Which code correctly performs all these actions in one chain?

hard

A. actions.moveToElement(menu).contextClick(subMenu).doubleClick(option).perform();

B. actions.moveToElement(menu).click(subMenu).doubleClick(option).perform();

C. actions.contextClick(menu).moveToElement(subMenu).doubleClick(option).perform();

D. actions.doubleClick(menu).contextClick(subMenu).moveToElement(option).perform();

Solution

1. Step 1: Understand the required sequence of actions

   The task is to hover (moveToElement) over 'menu', then right-click (contextClick) on 'subMenu', then double-click (doubleClick) on 'option'.

2. Step 2: Match methods to actions and order

   actions.moveToElement(menu).contextClick(subMenu).doubleClick(option).perform(); correctly chains moveToElement(menu), contextClick(subMenu), and doubleClick(option), then calls perform() to execute.

3. Final Answer:

   actions.moveToElement(menu).contextClick(subMenu).doubleClick(option).perform(); -> Option A

4. Quick Check:

   Hover, right-click, double-click in order [OK]

Hint: Chain actions in order, end with perform() [OK]

Common Mistakes:

• Mixing order of actions
• Using click instead of contextClick for right-click
• Calling perform() before all actions