自动化测试 / 系统课时
选择稳定定位策略
选择稳定定位策略
定位器能不能长期使用,取决于它是否绑定到稳定的页面契约,而不是选择器写得多复杂。本节用 Selenium 4.x 的 Python 绑定比较稳定属性、深层路径和位置索引,并用一次 DOM 结构改动验证哪种定位方式更抗变化。
学习目标
- 按稳定性选择
id、CSS 属性选择器与 XPath 等定位方式 - 识别动态属性、深层 DOM 路径和位置索引带来的脆弱性
- 用唯一性与结构变更检查验证定位器是否适合长期维护
优先使用可预测的页面属性
如果页面提供唯一且稳定的 id,优先使用 By.ID。没有合适的 id 时,可以和前端约定专门的 data-* 测试属性,例如 data-testid="checkout-submit",再用 CSS 属性选择器定位。name、aria-label 等属性也能使用,但前提是它们在产品中确实稳定。
| 场景 | 脆弱写法 | 更稳定的写法 |
|---|---|---|
| 提交按钮 | div:nth-child(3) > button |
#checkout-submit |
| 保存按钮 | .css-18x9a7 这类构建生成类名 |
[data-testid="profile-save"] |
| 邮箱输入框 | form > div > div > input |
input[name="email"] |
| 表格操作按钮 | (//button)[4] |
先定位目标行,再在行内找 [data-action="edit"] |
不要把“CSS 一定稳定”或“XPath 一定脆弱”当成规则。真正需要避免的是依赖易变的类名、完整祖先链和固定位置;XPath 在需要按文本或节点关系定位时仍然有价值,但表达式应尽量短,并绑定到稳定锚点。
用结构改动验证选择器
下面的页面最初让深层 CSS 和 data-testid 都能找到按钮。随后脚本只插入一层包装节点,不修改按钮本身;深层路径立即失效,而基于测试属性的定位仍然唯一命中。
from urllib.parse import quote
from selenium import webdriver
from selenium.webdriver.common.by import By
html = '''
<main>
<section>
<form>
<div class="actions">
<button type="button" data-testid="profile-save">保存</button>
</div>
</form>
</section>
</main>
'''
driver = webdriver.Chrome()
try:
driver.get("data:text/html;charset=utf-8," + quote(html))
# 同时保留一个结构型定位器和一个稳定属性定位器作对照。
deep = "main > section > form > div.actions > button"
stable = '[data-testid="profile-save"]'
print("before", len(driver.find_elements(By.CSS_SELECTOR, deep)),
len(driver.find_elements(By.CSS_SELECTOR, stable)))
# 模拟前端重构:只给按钮增加一层包装节点。
script = (
"const button = document.querySelector('[data-testid=\"profile-save\"]');"
"const wrapper = document.createElement('div');"
"button.parentNode.insertBefore(wrapper, button);"
"wrapper.appendChild(button);"
)
driver.execute_script(script)
print("after", len(driver.find_elements(By.CSS_SELECTOR, deep)),
len(driver.find_elements(By.CSS_SELECTOR, stable)))
finally:
driver.quit()预期输出
before 1 1
after 0 1这个结果说明深层路径描述的是“按钮当前放在哪里”,而稳定属性描述的是“这个按钮是谁”。测试通常更应该依赖后者,因为页面增加容器、调整栅格或更换样式类时,不应迫使业务测试同步修改定位器。
建立可执行的定位优先级
实际项目可以按下面的顺序评审定位器:先看是否有唯一、可预测的 id;没有时使用团队承诺稳定的 data-* 属性;再考虑稳定的 name、可访问性属性或短 CSS;只有当元素身份必须依赖文本、祖先或兄弟关系时,再使用简短 XPath。
位置索引只应在“第几个”本身就是业务条件时出现。例如测试分页中的第 3 个页码可以使用位置;但“第三个按钮恰好是保存按钮”不是稳定契约。动态哈希类名、运行时生成的 id、整页绝对 XPath 也不应成为长期定位器。
提交前做三项检查
定位器合并进测试代码前,至少做三个检查:目标状态下匹配数量应符合预期,唯一控件必须始终是 1;给目标元素前后插入一个无关兄弟节点后,定位器不应因为位置变化而失效;刷新或切换同一路由的不同数据状态后,稳定属性值仍应保持一致。
如果一个定位器必须依赖页面结构,先把搜索范围缩到稳定容器,例如先定位订单行,再在该行内部找编辑按钮。这样即使页面其他区域增加相同按钮,也不会让当前测试误点到错误元素。