自动化测试 / 系统课时
使用 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 浏览器可用。
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()预期输出
alice@example.com
Save
Orders如果 find_element 找不到元素,会抛出 NoSuchElementException;如果选择器语法本身非法,通常会得到 InvalidSelectorException。因此排错时要先区分“表达式错误”和“页面中没有匹配项”。
处理层级与重复元素
页面中同类按钮很多时,不要依赖全局位置。例如 .card:nth-of-type(3) button 会因为前面插入新卡片而改变目标。更稳的做法是先定位包含稳定属性的容器,再在容器内继续查找。
片段示例(依赖已创建且打开目标页面的 driver):
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(...) 先确认匹配数量是否符合预期。