12.Actions的相关操作

作者

12. Actions的相关操作

什么是Actions类？

Actions类是Selenium WebDriver提供的一个高级用户交互API，用于模拟复杂的用户操作，如鼠标悬停、拖拽、键盘组合键等。它可以构建一系列动作，然后一次性执行。

导入Actions类

import org.openqa.selenium.interactions.Actions;

创建Actions对象

WebDriver driver = new ChromeDriver();
Actions actions = new Actions(driver);

常用的鼠标操作

1. 鼠标点击操作

左键点击

// 点击指定元素
WebElement element = driver.findElement(By.id("button"));
actions.click(element).perform();

// 在当前鼠标位置点击
actions.click().perform();

右键点击

WebElement element = driver.findElement(By.id("button"));
actions.contextClick(element).perform();

双击

WebElement element = driver.findElement(By.id("button"));
actions.doubleClick(element).perform();

2. 鼠标悬停操作

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

3. 鼠标拖拽操作

拖拽到指定元素

WebElement source = driver.findElement(By.id("source"));
WebElement target = driver.findElement(By.id("target"));
actions.dragAndDrop(source, target).perform();

拖拽指定距离

WebElement element = driver.findElement(By.id("draggable"));
actions.dragAndDropBy(element, 100, 200).perform(); // x偏移100，y偏移200

4. 鼠标按下和释放

WebElement element = driver.findElement(By.id("button"));
actions.clickAndHold(element).perform(); // 按下不释放
actions.release(element).perform();      // 释放

常用的键盘操作

1. 发送键盘输入

WebElement input = driver.findElement(By.id("input"));
actions.sendKeys(input, "Hello World").perform();

// 在当前焦点元素输入
actions.sendKeys("Hello World").perform();

2. 组合键操作

Ctrl组合键

// Ctrl+A 全选
actions.keyDown(Keys.CONTROL).sendKeys("a").keyUp(Keys.CONTROL).perform();

// Ctrl+C 复制
actions.keyDown(Keys.CONTROL).sendKeys("c").keyUp(Keys.CONTROL).perform();

// Ctrl+V 粘贴
actions.keyDown(Keys.CONTROL).sendKeys("v").keyUp(Keys.CONTROL).perform();

Shift组合键

// Shift+Tab
actions.keyDown(Keys.SHIFT).sendKeys(Keys.TAB).keyUp(Keys.SHIFT).perform();

Alt组合键

// Alt+Tab
actions.keyDown(Keys.ALT).sendKeys(Keys.TAB).keyUp(Keys.ALT).perform();

3. 功能键操作

// 按下回车键
actions.sendKeys(Keys.ENTER).perform();

// 按下Tab键
actions.sendKeys(Keys.TAB).perform();

// 按下Esc键
actions.sendKeys(Keys.ESCAPE).perform();

// 按下方向键
actions.sendKeys(Keys.ARROW_UP).perform();
actions.sendKeys(Keys.ARROW_DOWN).perform();
actions.sendKeys(Keys.ARROW_LEFT).perform();
actions.sendKeys(Keys.ARROW_RIGHT).perform();

复杂操作示例

1. 多步骤操作链

WebElement element1 = driver.findElement(By.id("element1"));
WebElement element2 = driver.findElement(By.id("element2"));

// 构建一系列操作，最后统一执行
actions.moveToElement(element1)
       .click()
       .sendKeys("Hello")
       .keyDown(Keys.CONTROL)
       .sendKeys("a")
       .keyUp(Keys.CONTROL)
       .sendKeys("World")
       .moveToElement(element2)
       .click()
       .perform(); // 执行所有操作

2. 滑块操作

// 滑块拖拽
WebElement slider = driver.findElement(By.className("slider"));
actions.clickAndHold(slider)
       .moveByOffset(100, 0) // 向右移动100像素
       .release()
       .perform();

3. 文件上传拖拽

// 模拟文件拖拽到上传区域
WebElement uploadArea = driver.findElement(By.id("upload-area"));
actions.moveToElement(uploadArea)
       .click()
       .perform();

高级操作技巧

1. 鼠标移动到指定坐标

// 移动到元素的指定偏移位置
WebElement element = driver.findElement(By.id("target"));
actions.moveToElement(element, 50, 30).perform(); // 相对于元素左上角偏移

// 移动到屏幕绝对坐标
actions.moveByOffset(100, 200).perform();

2. 模拟鼠标滚轮

WebElement element = driver.findElement(By.id("scrollable"));
// 注意：滚轮操作在不同浏览器中可能表现不同
actions.moveToElement(element)
       .sendKeys(Keys.PAGE_DOWN)
       .perform();

3. 链式操作的暂停

// 在操作之间添加暂停
actions.moveToElement(element1)
       .pause(Duration.ofSeconds(1)) // 暂停1秒
       .click()
       .pause(Duration.ofMillis(500)) // 暂停500毫秒
       .sendKeys("Hello")
       .perform();

实际应用场景

1. 处理下拉菜单

// 悬停显示下拉菜单，然后点击子菜单
WebElement mainMenu = driver.findElement(By.id("main-menu"));
WebElement subMenu = driver.findElement(By.id("sub-menu"));

actions.moveToElement(mainMenu)
       .pause(Duration.ofMillis(500))
       .moveToElement(subMenu)
       .click()
       .perform();

2. 表格行选择

// 按住Ctrl键选择多行
WebElement row1 = driver.findElement(By.xpath("//tr[1]"));
WebElement row3 = driver.findElement(By.xpath("//tr[3]"));

actions.click(row1)
       .keyDown(Keys.CONTROL)
       .click(row3)
       .keyUp(Keys.CONTROL)
       .perform();

3. 文本选择和操作

WebElement textArea = driver.findElement(By.id("textarea"));

// 全选文本并替换
actions.click(textArea)
       .keyDown(Keys.CONTROL)
       .sendKeys("a")
       .keyUp(Keys.CONTROL)
       .sendKeys("新的文本内容")
       .perform();

注意事项和最佳实践

1. 必须调用perform()方法

// 错误：没有调用perform()，操作不会执行
actions.click(element);

// 正确：调用perform()执行操作
actions.click(element).perform();

2. 操作前确保元素可见

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

// 确保元素可见
WebDriverWait wait = new WebDriverWait(driver, Duration.ofSeconds(10));
wait.until(ExpectedConditions.visibilityOf(element));

// 然后执行Actions操作
actions.click(element).perform();

3. 处理操作失败

try {
    WebElement element = driver.findElement(By.id("button"));
    actions.moveToElement(element).click().perform();
} catch (Exception e) {
    System.out.println("Actions操作失败: " + e.getMessage());
    // 可以尝试其他方式，如直接点击
    element.click();
}

4. 复杂操作的调试

// 分步执行便于调试
actions.moveToElement(element).perform();
Thread.sleep(1000); // 观察效果

actions.click().perform();
Thread.sleep(1000); // 观察效果

actions.sendKeys("Hello").perform();

常见问题和解决方案

1. Actions操作无效果

原因：

  • 忘记调用perform()方法
  • 元素不可见或不可交互
  • 页面还在加载中

解决方案：

// 添加等待和检查
WebDriverWait wait = new WebDriverWait(driver, Duration.ofSeconds(10));
WebElement element = wait.until(ExpectedConditions.elementToBeClickable(By.id("button")));
actions.click(element).perform();

2. 拖拽操作不准确

解决方案：

// 使用更精确的拖拽方法
WebElement source = driver.findElement(By.id("source"));
WebElement target = driver.findElement(By.id("target"));

actions.clickAndHold(source)
       .pause(Duration.ofMillis(500))
       .moveToElement(target)
       .pause(Duration.ofMillis(500))
       .release()
       .perform();

3. 组合键在不同系统表现不同

解决方案：

// 检测操作系统并使用相应的组合键
String os = System.getProperty("os.name").toLowerCase();
Keys cmdKey = os.contains("mac") ? Keys.COMMAND : Keys.CONTROL;

actions.keyDown(cmdKey).sendKeys("c").keyUp(cmdKey).perform();

总结

Actions类是Selenium中处理复杂用户交互的强大工具，主要用于：

  1. 鼠标操作：点击、悬停、拖拽、右键等
  2. 键盘操作：输入文本、组合键、功能键等
  3. 复杂交互：多步骤操作链、精确控制等

使用Actions类时要记住：

  • 必须调用perform()方法执行操作
  • 确保元素可见和可交互
  • 可以链式调用多个操作
  • 适当添加等待时间提高稳定性

通过熟练掌握Actions类，您可以模拟几乎所有的用户交互行为，大大提升自动化测试的覆盖范围和真实性。

发表评论