自动化测试 / 系统课时

选择稳定定位策略

选择稳定定位策略

定位器能不能长期使用,取决于它是否绑定到稳定的页面契约,而不是选择器写得多复杂。本节用 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 都能找到按钮。随后脚本只插入一层包装节点,不修改按钮本身;深层路径立即失效,而基于测试属性的定位仍然唯一命中。

python
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()

预期输出

text
before 1 1
after 0 1

这个结果说明深层路径描述的是“按钮当前放在哪里”,而稳定属性描述的是“这个按钮是谁”。测试通常更应该依赖后者,因为页面增加容器、调整栅格或更换样式类时,不应迫使业务测试同步修改定位器。

建立可执行的定位优先级

实际项目可以按下面的顺序评审定位器:先看是否有唯一、可预测的 id;没有时使用团队承诺稳定的 data-* 属性;再考虑稳定的 name、可访问性属性或短 CSS;只有当元素身份必须依赖文本、祖先或兄弟关系时,再使用简短 XPath。

位置索引只应在“第几个”本身就是业务条件时出现。例如测试分页中的第 3 个页码可以使用位置;但“第三个按钮恰好是保存按钮”不是稳定契约。动态哈希类名、运行时生成的 id、整页绝对 XPath 也不应成为长期定位器。

提交前做三项检查

定位器合并进测试代码前,至少做三个检查:目标状态下匹配数量应符合预期,唯一控件必须始终是 1;给目标元素前后插入一个无关兄弟节点后,定位器不应因为位置变化而失效;刷新或切换同一路由的不同数据状态后,稳定属性值仍应保持一致。

如果一个定位器必须依赖页面结构,先把搜索范围缩到稳定容器,例如先定位订单行,再在该行内部找编辑按钮。这样即使页面其他区域增加相同按钮,也不会让当前测试误点到错误元素。

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

目录与阅读设置

阅读设置

17

记录一个想法

选择稳定定位策略

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

登录哪都通