自动化测试 / 系统课时

使用 CSS 选择器

使用 CSS 选择器

CSS 选择器适合定位结构稳定、属性明确的页面元素。掌握 ID、类、属性、层级与组合写法后,可以把大多数定位表达式压缩到一行,并直接交给浏览器原生选择器引擎执行。

学习目标

  • 使用 #id、.class、属性选择器和组合选择器定位元素。
  • 用父子、后代与 :nth-of-type() 处理层级和重复节点。
  • 识别过度依赖 DOM 层级、动态类名和非标准伪类的脆弱写法。

选择器构造规则

在 Selenium Python 中,CSS 定位统一使用 By.CSS_SELECTOR。优先从稳定且唯一的属性开始,再按需要叠加标签、类名和层级,不要一上来复制浏览器生成的超长路径。

目标 CSS 选择器 说明
id="login" #login ID 稳定时最短
class="btn primary" .btn.primary 同时具备两个类
name="email" input[name="email"] 标签加属性可缩小范围
data-testid="save" [data-testid="save"] 自动化专用属性通常更稳定
直接子元素 .toolbar > button 只匹配下一层
任意后代 .dialog button 可跨越多层
第 2 个同类元素 .menu li:nth-of-type(2) 按同标签兄弟顺序计数

button.primary[data-action="save"] 是一个常用组合:元素必须同时是 button、包含 primary 类,并且 data-action 等于 save。条件越贴近业务语义,定位通常越稳定。

用完整页面验证定位

下面示例适用于 Selenium 4.6+ Python。脚本先生成一个本地 HTML 文件,再分别使用 ID、属性、直接子元素和组合选择器取值;运行前需要已安装 Selenium,并有 Chrome 浏览器可用。

python
from pathlib import Path
from selenium import webdriver
from selenium.webdriver.common.by import By

html = '''<!doctype html>
<html>
<body>
  <form id="login-form">
    <input name="email" value="alice@example.com">
    <button class="btn primary" data-action="save">Save</button>
  </form>
  <ul class="menu">
    <li>Home</li>
    <li>Orders</li>
  </ul>
</body>
</html>'''

page = Path("css-demo.html").resolve()
page.write_text(html, encoding="utf-8")

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

    form = driver.find_element(By.CSS_SELECTOR, "#login-form")
    email = driver.find_element(By.CSS_SELECTOR, 'input[name="email"]')
    save = form.find_element(
        By.CSS_SELECTOR,
        'button.btn.primary[data-action="save"]'
    )
    second_item = driver.find_element(
        By.CSS_SELECTOR,
        ".menu > li:nth-of-type(2)"
    )

    print(email.get_attribute("value"))
    print(save.text)
    print(second_item.text)
finally:
    driver.quit()

预期输出

text
alice@example.com
Save
Orders

如果 find_element 找不到元素,会抛出 NoSuchElementException;如果选择器语法本身非法,通常会得到 InvalidSelectorException。因此排错时要先区分“表达式错误”和“页面中没有匹配项”。

处理层级与重复元素

页面中同类按钮很多时,不要依赖全局位置。例如 .card:nth-of-type(3) button 会因为前面插入新卡片而改变目标。更稳的做法是先定位包含稳定属性的容器,再在容器内继续查找。

片段示例(依赖已创建且打开目标页面的 driver):

python
card = driver.find_element(
    By.CSS_SELECTOR,
    'section.card[data-order-id="A1024"]'
)
details = card.find_element(
    By.CSS_SELECTOR,
    'button[data-action="details"]'
)

生效结果是查找范围先被限制到订单 A1024 的卡片,再只在该卡片中寻找详情按钮;验证时可打印 details.text 或检查其 data-action 属性。

识别脆弱写法

CSS 选择器不能直接按可见文本做标准匹配,:contains("Save") 不是浏览器标准 CSS 选择器,交给 Selenium 会失败。需要按文本定位时,应改用 XPath,或让页面提供稳定属性。

另一个常见错误是复制完整层级,如 body > div:nth-of-type(2) > div > form > button:nth-of-type(1)。这种表达式把布局细节当成业务标识,只要页面多包一层容器就会失效。实际项目中应优先采用“稳定属性 + 最少必要层级”的表达式,并在 DevTools 控制台用 document.querySelectorAll(...) 先确认匹配数量是否符合预期。

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

目录与阅读设置

阅读设置

17

记录一个想法

使用 CSS 选择器

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

登录哪都通