自动化测试 / 系统课时
定位多个元素
定位多个元素
当页面里有商品卡片、表格行或重复按钮时,find_elements 可以一次取得全部匹配元素,再逐项读取或操作。这里用 Selenium 4.x 的 Python 绑定演示集合获取、父元素内查找,以及 0 个结果时的安全处理。
学习目标
- 使用
find_elements获取并遍历多个WebElement - 在父元素范围内继续查找,减少同名元素误匹配
- 正确处理空集合、单个结果和页面刷新后的元素引用
用 find_elements 获取元素集合
driver.find_elements(By.CSS_SELECTOR, selector) 返回 Python 列表;匹配 3 个元素就得到 3 个 WebElement,没有匹配项时返回空列表。它不会像 find_element 那样因为找不到元素而直接抛出 NoSuchElementException。
下面的示例同时遍历重复商品卡片和表格行。运行前需要已安装 Selenium 4.x,并且本机有可用的 Chrome。
from urllib.parse import quote
from selenium import webdriver
from selenium.webdriver.common.by import By
html = '''
<ul id="products">
<li class="product-card" data-sku="A01"><span class="name">键盘</span><span class="price">299</span></li>
<li class="product-card" data-sku="A02"><span class="name">鼠标</span><span class="price">129</span></li>
<li class="product-card" data-sku="A03"><span class="name">耳机</span><span class="price">399</span></li>
</ul>
<table id="orders">
<tbody>
<tr><td>1001</td><td>已支付</td></tr>
<tr><td>1002</td><td>待发货</td></tr>
</tbody>
</table>
'''
driver = webdriver.Chrome()
try:
driver.get("data:text/html;charset=utf-8," + quote(html))
# 每个卡片都作为一个独立搜索上下文,再取其内部字段。
cards = driver.find_elements(By.CSS_SELECTOR, "#products .product-card")
print(f"cards={len(cards)}")
for card in cards:
name = card.find_element(By.CLASS_NAME, "name").text
price = card.find_element(By.CLASS_NAME, "price").text
print(card.get_attribute("data-sku"), name, price)
# 先找到表格,再只在表格内部收集行,避免匹配页面其他 tr。
table = driver.find_element(By.ID, "orders")
rows = table.find_elements(By.CSS_SELECTOR, "tbody tr")
print(f"orders={len(rows)}")
for row in rows:
cells = row.find_elements(By.TAG_NAME, "td")
print(cells[0].text, cells[1].text)
finally:
driver.quit()预期输出
cards=3
A01 键盘 299
A02 鼠标 129
A03 耳机 399
orders=2
1001 已支付
1002 待发货先缩小范围再遍历
重复组件最常见的问题不是“找不到”,而是“找多了”。例如页面同时有订单表和审计表时,直接使用 tbody tr 会把两个表格的行混在一起;先用 By.ID, "orders" 找到目标表格,再调用 table.find_elements(By.CSS_SELECTOR, "tbody tr"),搜索范围就被限制在该表格的后代节点中。
同样的方法适用于列表和卡片:先找稳定容器 #products,再找 .product-card;进入单个卡片后,再查 .name、.price。这种“容器 → 重复项 → 字段”的两级定位,比在整页写很长的 CSS 路径更容易检查,也能避免相同类名造成串数据。
正确处理结果数量与失效引用
集合结果应先根据业务预期检查数量,再决定是遍历还是取下标。对“允许没有结果”的搜索使用 find_elements 很合适;对“必须唯一存在”的按钮或输入框,通常直接使用 find_element 更能暴露页面异常。
| 页面状态 | find_elements 结果 |
推荐处理 |
|---|---|---|
| 0 个匹配 | [] |
判断 if not elements,不要直接访问 elements[0] |
| 1 个匹配 | 长度为 1 的列表 | 若业务要求唯一,可断言 len(elements) == 1 |
| 多个匹配 | 按 DOM 顺序返回列表 | 遍历并从元素自身读取标识,不依赖固定下标 |
如果页面刷新、局部组件重新渲染或节点被替换,之前保存的 WebElement 可能变成失效引用。此时不要长期缓存列表;在页面状态变化完成后重新调用 find_elements 获取新集合,再继续遍历。