自动化测试 / 系统课时

使用 Actions API

使用 Actions API

普通的 click()、send_keys() 适合单一步骤;遇到“移动鼠标后按键、按住修饰键再点击、连续拖动”等组合交互时,需要 Actions API 把多个输入动作组织成一条链,再统一发送给浏览器执行。

学习目标

  • 理解 ActionChains 构建动作与 perform() 执行动作的区别。
  • 能组合鼠标移动、点击、键盘输入和暂停动作。
  • 能判断动作链中元素失效、修饰键未释放等常见问题。

理解动作链怎样执行

Selenium Python 4.x 中常用的高级交互入口是 selenium.webdriver.common.action_chains.ActionChains。调用 move_to_element()、click()、send_keys() 等方法时,主要是在构建待执行动作;直到调用 perform(),Selenium 才把动作序列通过 WebDriver 发送给浏览器。

例如“移动到输入框 → 点击获得焦点 → 输入文本 → 暂停 0.2 秒 → 移到按钮 → 点击”可以组成一次动作链。它比把六个操作散落在测试代码中更容易表达连续交互的顺序,也适合需要指针和键盘协作的场景。

Actions API 从动作构建到浏览器执行的关系

构建并执行一条完整动作链

下面示例使用本地 data: 页面,不依赖测试网站。运行前需要安装 Selenium 4.x,并确保本机存在 Selenium 支持的 Chrome;webdriver.Chrome() 会按当前 Selenium 配置启动浏览器。

python
from urllib.parse import quote

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

html = '''
<input id="name" placeholder="Name">
<button id="save" onclick="document.getElementById('out').textContent=document.getElementById('name').value">Save</button>
<p id="out"></p>
'''

driver = webdriver.Chrome()
try:
    driver.get("data:text/html;charset=utf-8," + quote(html))

    name = driver.find_element(By.ID, "name")
    save = driver.find_element(By.ID, "save")

    # 先构建连续输入动作,最后一次性执行。
    actions = ActionChains(driver)
    actions.move_to_element(name).click()
    actions.send_keys("Anystack").pause(0.2)
    actions.move_to_element(save).click()
    actions.perform()

    print(driver.find_element(By.ID, "out").text)
finally:
    driver.quit()

预期输出

text
Anystack

这里的 pause(0.2) 表示在动作序列中插入约 0.2 秒停顿,它适合模拟确实需要短暂停顿的组合输入,但不应代替显式等待。等待 AJAX、动画完成或元素出现时,仍应使用 WebDriverWait 判断真实页面条件。

把输入设备和动作顺序对应起来

Actions API 底层面向的是输入设备。鼠标移动、按下和释放属于 pointer 输入;普通字符和 Keys.SHIFT、Keys.CONTROL 等属于 keyboard 输入;滚动动作属于 wheel 输入。实际编写测试时不必手工组织底层数据,但应知道不同输入状态可以相互影响。

例如需要按住 Shift 再点击元素时,应在同一交互中成对安排 key_down(Keys.SHIFT) 和 key_up(Keys.SHIFT)。错误做法是只按下修饰键而没有释放,因为后续输入可能继续受到该键状态影响。一个测试场景结束后,也不建议把同一个 ActionChains 实例长期保存并跨多个业务步骤复用;按一次完整交互新建动作链更容易审查执行顺序。

处理动作链最常见的失败

动作链在 perform() 时才真正与页面交互,因此“构建成功”不代表执行一定成功。最常见的问题之一是先保存了元素对象,页面随后被前端框架重新渲染,最终执行时原元素已失效并产生 StaleElementReferenceException。正确做法是在状态稳定后重新定位目标,再创建和执行动作链。

另一个常见问题是把固定暂停当成同步机制。例如菜单需要 1.5 秒才能加载,却只写 pause(0.2),测试会随机器性能波动。固定暂停只用于动作本身需要的节奏;等待页面状态时应以“元素可见、可点击、文本出现”等条件为准。

对于带修饰键的交互,还要检查按下和释放是否成对。对于鼠标动作,则应先确认目标仍在当前文档中且没有被遮罩层替换。这样排查时可以把问题明确分成“动作序列写错”“目标元素状态变化”和“页面同步不足”三类,而不是简单增加等待时间。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

使用 Actions API

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通