自动化测试 / 系统课时

使用 name 与类名定位

使用 name 与类名定位

name 适合定位表单字段,类名适合定位带有稳定单个 CSS class 的通用元素。本课使用 Selenium Python 的 By.NAME 与 By.CLASS_NAME 完成定位,并重点处理类名中常见的“多个 class 写在一起”错误。

学习目标

  • 使用 By.NAME 精确读取带 name 属性的表单元素
  • 使用 By.CLASS_NAME 定位拥有某个单独 class 的元素集合
  • 判断何时应改用 CSS 选择器而不是类名定位

name 与类名分别匹配什么

By.NAME 匹配元素的 name 属性,例如 <input name="email"> 应使用 driver.find_element(By.NAME, "email")。find_element 返回第一个匹配元素;需要全部匹配项时使用 find_elements,返回 WebElement 列表。

By.CLASS_NAME 接收的是一个类名,而不是完整的 class 属性文本。若元素为 <input class="field primary">,可分别用 field 或 primary 定位,但不能把 field primary 作为 By.CLASS_NAME 的值。需要同时要求两个 class 时,改用 CSS 选择器 .field.primary。

运行一个完整定位示例

下面示例把测试 HTML 直接放进 data: 页面,因此不依赖外部网站。运行前确保已安装 Selenium,并且本机有可启动的 Chrome;示例适用于 Selenium Python 4.x。

python
from urllib.parse import quote

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

html = '''
<form>
  <input name="username" class="field primary" value="alice">
  <input name="email" class="field" value="alice@example.com">
  <button type="button" class="submit-btn">Send</button>
</form>
'''

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

    email = driver.find_element(By.NAME, "email")
    fields = driver.find_elements(By.CLASS_NAME, "field")
    button = driver.find_element(By.CLASS_NAME, "submit-btn")

    print("email:", email.get_attribute("value"))
    print("field count:", len(fields))
    print("button:", button.text)
finally:
    driver.quit()

预期输出:

text
email: alice@example.com
field count: 2
button: Send

实际浏览器启动日志可能因 Chrome、驱动和 Selenium 版本不同而额外出现,但三行 print 结果应一致。若第一行报找不到元素,先在开发者工具检查目标元素是否真的存在 name="email",而不是把 id 或占位文字误当成 name。

处理多个 class 与重复 name

类名定位最常见的错误是把整个 class 属性复制进去。例如 class="field primary" 时,错误写法是 By.CLASS_NAME, "field primary";正确做法是选一个稳定单类名,或使用 By.CSS_SELECTOR, ".field.primary" 表示两个 class 必须同时存在。

name 也不保证唯一。单选框常见多个元素共享 name="plan",这时应使用 find_elements(By.NAME, "plan"),再结合 value、可见文本或其他稳定属性判断目标。若业务要求“必须唯一”,可以在测试里先断言匹配数量为 1,再继续操作。

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

目录与阅读设置

阅读设置

17

记录一个想法

使用 name 与类名定位

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

登录哪都通