自动化测试 / 系统课时

使用 id 定位元素

使用 id 定位元素

id 是 Selenium 中最直接的定位入口之一。只要页面为目标元素提供稳定且唯一的 id,就可以用 By.ID 得到对应的 WebElement。本课用本地页面完成输入、点击和结果验证,并说明重复、动态和暂未出现的 id 应怎样处理。

学习目标

  • 能使用 By.ID 精确定位页面元素并执行操作。
  • 能判断一个 id 是否适合作为自动化测试的稳定定位依据。
  • 能按固定顺序排查 NoSuchElementException 和重复 id 问题。

id 定位的基本规则

Python 写法是 driver.find_element(By.ID, "username")。第二个参数只填写属性值 username,不要写成 #username;#username 是 CSS 选择器语法,只有使用 By.CSS_SELECTOR 时才这样写。

片段示例:页面中适合按 id 定位的元素。

html
<input id="username" name="username">
<button id="login-btn" type="button">登录</button>

同一文档中一个 id 应只对应一个元素。测试代码可以把业务稳定的 id 当作明确契约,例如 checkout-submit、profile-save;不要依赖每次构建或渲染都可能变化的编号型 id,例如 button-18473。

完整执行一次 id 定位

下面示例适用于 Selenium 4.x、Python 3.10+。它创建一个本地登录页,分别按 username、login-btn 和 status 三个 id 定位元素,完成输入与点击,再读取页面结果。

python
from pathlib import Path
from tempfile import TemporaryDirectory

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

html = '''<!doctype html>
<html lang="zh-CN">
<body>
  <input id="username" value="">
  <button id="login-btn" type="button"
          onclick="document.getElementById('status').textContent='ready'">
    登录
  </button>
  <p id="status">idle</p>
</body>
</html>'''

with TemporaryDirectory() as tmp:
    page = Path(tmp) / "login.html"
    page.write_text(html, encoding="utf-8")

    driver = webdriver.Chrome()
    try:
        driver.get(page.as_uri())

        username = driver.find_element(By.ID, "username")
        username.send_keys("alice")

        driver.find_element(By.ID, "login-btn").click()
        status = driver.find_element(By.ID, "status")

        print(username.get_attribute("value"))
        print(status.text)
    finally:
        driver.quit()

预期输出

text
alice
ready

输出 alice 说明输入框定位正确且 send_keys() 已生效;ready 说明按钮定位、点击以及状态节点读取都成功。真实项目中也应让“定位后操作”和“可观察结果”成对出现,而不是只验证脚本没有抛异常。

检查 id 是否真的唯一

在浏览器开发者工具的 Console 中,可以直接统计同一 id 的匹配数量。把 login-btn 换成实际页面的目标值;结果为 1 才符合唯一定位的预期。

js
document.querySelectorAll('#login-btn').length

预期输出

text
1

如果结果是 0,说明当前 DOM 中没有该元素;如果大于 1,页面存在重复 id。重复 id 时不要依赖 Selenium “碰巧找到某一个”,应先修复页面标记,或在无法修改页面时改用更能表达范围的 CSS、XPath 或父子节点定位。

找不到元素时按顺序排查

find_element(By.ID, "target") 找不到元素时会抛出 NoSuchElementException。排查时先确认拼写,再确认当前浏览上下文,最后确认元素出现时机;这比直接把定位器改成复杂 XPath 更容易找到根因。

  1. 在 Elements 面板搜索 id="target",确认属性值完全一致,注意大小写和前后空格。
  2. 若元素位于 iframe,先切换到对应 frame,再定位;默认上下文只能看到当前 document。
  3. 若元素由异步请求渲染,使用显式等待,例如最多等待 10 秒直到元素出现。
  4. 若页面跳转或重渲染后再操作,重新调用 find_element,不要继续使用旧页面保存下来的元素对象。

对于稳定业务页面,优先让前端提供语义明确且长期不变的 id,例如 order-submit。当 id 的稳定性无法保证时,再选择 name、CSS 选择器或其他定位策略;定位表达式越短不代表越可靠,真正要检查的是它是否唯一、稳定并属于正确的页面上下文。

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

目录与阅读设置

阅读设置

17

记录一个想法

使用 id 定位元素

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

登录哪都通