Action chains in Selenium Python

Introduction

Action chains let you do complex mouse and keyboard actions step-by-step. They help test things like drag-and-drop or hover effects.

You want to test dragging an item from one place to another on a webpage.

You need to hover over a menu to see a dropdown and click an option.

You want to simulate holding down a key while clicking.

You want to test double-click or right-click actions.

You need to move the mouse to a specific spot before clicking.

Syntax

Selenium Python

from selenium.webdriver import ActionChains

actions = ActionChains(driver)
actions.move_to_element(element).click().perform()

Always call perform() at the end to run the actions.

You can chain many actions before calling perform().

Examples

Move mouse to a button and click it.

Selenium Python

actions = ActionChains(driver)
actions.move_to_element(button).click().perform()

Drag an element from source to target and release the mouse.

Selenium Python

actions = ActionChains(driver)
actions.click_and_hold(source).move_to_element(target).release().perform()

Double-click on an element.

Selenium Python

actions = ActionChains(driver)
actions.double_click(element).perform()

Right-click (context click) on an element.

Selenium Python

actions = ActionChains(driver)
actions.context_click(element).perform()

Sample Program

This script opens a demo page, drags the blue box onto the gray box, and prints the text inside the target box after dropping. The text changes to "Dropped!" if successful.

Selenium Python

from selenium import webdriver
from selenium.webdriver.common.by import By
from selenium.webdriver import ActionChains
import time

# Setup driver (make sure chromedriver is in PATH)
driver = webdriver.Chrome()
driver.get('https://crossbrowsertesting.github.io/drag-and-drop.html')

# Find source and target elements
source = driver.find_element(By.ID, 'draggable')
target = driver.find_element(By.ID, 'droppable')

# Create action chain to drag and drop
actions = ActionChains(driver)
actions.click_and_hold(source).move_to_element(target).release().perform()

# Wait to see result
time.sleep(2)

# Check if drop was successful by text change
result_text = target.text
print(result_text)

driver.quit()

Important Notes

Action chains simulate real user actions step-by-step, so they are slower but more accurate than simple clicks.

Always import ActionChains from selenium.webdriver.

Use explicit waits if elements take time to appear before actions.

Summary

Action chains let you do complex mouse and keyboard actions in tests.

Chain multiple actions and call perform() to run them.

Useful for drag-and-drop, hover, double-click, and right-click tests.

Practice

1. What is the main purpose of using ActionChains in Selenium with Python?

easy

A. To locate elements on a web page

B. To perform complex mouse and keyboard actions in sequence

C. To write assertions for test validations

D. To start the Selenium WebDriver server

Solution

1. Step 1: Understand the role of ActionChains

   ActionChains is designed to handle complex user interactions like mouse movements, clicks, and keyboard inputs in a sequence.

2. Step 2: Compare with other options

   Locating elements, assertions, and starting the server are handled by other Selenium components, not ActionChains.

3. Final Answer:

   To perform complex mouse and keyboard actions in sequence -> Option B

4. Quick Check:

   ActionChains = complex actions [OK]

Hint: ActionChains = chain mouse/keyboard steps, then perform [OK]

Common Mistakes:

• Confusing ActionChains with element locating
• Thinking ActionChains runs tests or assertions
• Assuming ActionChains starts the WebDriver

2. Which of the following is the correct way to import and create an ActionChains object in Selenium Python?

easy

A. from selenium.webdriver import ActionChains
actions = ActionChains()

B. import ActionChains from selenium.webdriver
actions = ActionChains()

C. from selenium.webdriver.common.action_chains import ActionChains
actions = ActionChains(driver)

D. from selenium.webdriver.common.actions import ActionChains
actions = ActionChains(driver)

Solution

1. Step 1: Check the correct import path

   The correct import path is selenium.webdriver.common.action_chains for ActionChains.

2. Step 2: Verify object creation syntax

   ActionChains requires the WebDriver instance as an argument during creation, so ActionChains(driver) is correct.

3. Final Answer:

   from selenium.webdriver.common.action_chains import ActionChains actions = ActionChains(driver) -> Option C

4. Quick Check:

   Import from common.action_chains + pass driver [OK]

Hint: Import from common.action_chains and pass driver [OK]

Common Mistakes:

• Forgetting to pass driver to ActionChains constructor
• Using wrong import path or syntax
• Calling ActionChains without parentheses

3. What will be the result of the following code snippet?

from selenium.webdriver.common.action_chains import ActionChains

actions = ActionChains(driver)
actions.move_to_element(element).click().perform()

medium

A. Moves mouse to the element and clicks it

B. Clicks the element without moving the mouse

C. Throws an error because perform() is missing

D. Moves mouse but does not click the element

Solution

1. Step 1: Analyze the chained actions

   The code chains move_to_element(element) followed by click(), then calls perform() to execute both actions.

2. Step 2: Understand perform() role

   Calling perform() runs all chained actions in order, so the mouse moves to the element and clicks it.

3. Final Answer:

   Moves mouse to the element and clicks it -> Option A

4. Quick Check:

   move_to_element + click + perform = move and click [OK]

Hint: perform() runs all chained actions in order [OK]

Common Mistakes:

• Forgetting to call perform() so actions don't run
• Assuming click works without moving mouse first
• Thinking perform() is optional

4. Identify the error in this code snippet:

actions = ActionChains(driver)
actions.click(element)
actions.perform()

medium

A. No error; code will run correctly

B. perform() should be called on actions.click() directly

C. click() requires move_to_element before it

D. Missing parentheses after click method call

Solution

1. Step 1: Check click() method usage

   The click() method can accept an element as an argument to click it directly without needing move_to_element.

2. Step 2: Verify perform() call

   Calling perform() on the ActionChains object executes all queued actions correctly.

3. Final Answer:

   No error; code will run correctly -> Option A

4. Quick Check:

   click(element) + perform() = valid usage [OK]

Hint: click(element) works without move_to_element [OK]

Common Mistakes:

• Thinking move_to_element is always required before click
• Assuming perform() must be chained immediately
• Missing parentheses on click() (not the case here)

5. You want to drag an element from source and drop it onto target using ActionChains. Which code snippet correctly performs this action?

hard

A. actions.drag_and_drop(source, target).perform()

B. actions.click_and_hold(source).move_to_element(target).release().perform()

C. actions.move_to_element(source).click().move_to_element(target).click().perform()

D. Both B and D are correct ways to drag and drop

Solution

1. Step 1: Understand drag_and_drop method

   drag_and_drop(source, target) is a built-in ActionChains method that performs drag and drop in one call.

2. Step 2: Understand manual drag and drop steps

   Using click_and_hold(source), then move_to_element(target), then release() and perform() also correctly performs drag and drop manually.

3. Step 3: Evaluate other options

   actions.move_to_element(source).click().move_to_element(target).click().perform() clicks source and target separately, which is not a drag and drop action.

4. Final Answer:

   Both B and D are correct ways to drag and drop -> Option D

5. Quick Check:

   drag_and_drop or click_hold+move+release = drag-drop [OK]

Hint: Use drag_and_drop or click_hold+move+release [OK]

Common Mistakes:

• Using click instead of click_and_hold for drag
• Missing release() after moving element
• Confusing drag_and_drop with simple clicks