自动化测试 / 系统课时
配置跨浏览器测试
配置跨浏览器测试
本课把同一条 Selenium 用例变成浏览器与版本矩阵:先从 Grid 读取已注册槽位,再为 Chrome、Firefox、Edge 创建对应 Options,并把 browserVersion 作为会话匹配条件逐项执行和验收。
学习目标
- 用
browserName与browserVersion描述远程测试目标。 - 让同一条 pytest 用例自动覆盖 Grid 已注册的浏览器版本组合。
- 根据实际
driver.capabilities判断测试是否运行在预期环境。
明确浏览器与版本的匹配规则
Selenium 4 不需要用旧式 DesiredCapabilities 拼字典;远程会话应从具体浏览器的 Options 类开始。browserName 由 ChromeOptions、FirefoxOptions、EdgeOptions 自动提供,browser_version 会生成 W3C 能力 browserVersion,Grid 用这些能力选择可满足请求的槽位。
| 配置项 | 作用 | 实际做法 |
|---|---|---|
browserName |
选择浏览器家族 | 用对应 Options 类,不手写名称 |
browserVersion |
选择已注册版本 | 赋值给 options.browser_version |
platformName |
需要区分操作系统时再使用 | 赋值给 options.platform_name |
se:name |
给 Grid UI 标记测试名 | 用 options.set_capability() 设置 |
版本字符串必须以 Grid 实际上报为准。若 Node 的 stereotype 明确给出 browserVersion,最稳妥的做法是请求同一个完整字符串;若该字段为空,则当前 Node 只能按浏览器家族做宽匹配。要严格区分同一浏览器的多个版本,应在 Node 配置中为每个版本注册独立 stereotype。
准备可执行的测试环境
本节示例使用 Selenium 4 Python 绑定与 pytest。需要一个已经运行的 Grid;若只想在一台机器上练习,可在安装了多个浏览器的主机上启动 Standalone。--session-request-timeout 30 把无法匹配的会话等待上限设为 30 秒,便于本地排错。
python -m pip install -q -U selenium pytest
java -jar selenium-server.jar standalone --selenium-manager true --session-request-timeout 30预期结果:pytest 与 Selenium 安装完成,Grid 在 http://localhost:4444 监听,并为本机可用的浏览器注册槽位。Grid 进程会持续占用当前终端,因此实际操作时可先完成 Python 安装,再在单独终端运行第二条命令。
参数化同一条用例
下面的测试先调用 /status 收集所有 Chrome、Firefox、Edge 槽位。若 stereotype 带 browserVersion 就按“浏览器 + 版本”精确参数化;若版本为空则只按浏览器参数化,并在会话建立后从 driver.capabilities 记录真实版本。这样同一份断言无需复制。
import json
import urllib.request
import pytest
from selenium import webdriver
from selenium.webdriver.common.by import By
GRID_URL = "http://localhost:4444"
def discover_targets():
# 从 Grid 读取真实槽位,避免猜测当前安装的浏览器版本。
with urllib.request.urlopen(f"{GRID_URL}/status", timeout=5) as response:
nodes = json.load(response)["value"].get("nodes", [])
targets = set()
for node in nodes:
for slot in node.get("slots", []):
stereotype = slot.get("stereotype", {})
name = stereotype.get("browserName")
version = stereotype.get("browserVersion") or None
if name:
targets.add((name, version))
return sorted(targets, key=lambda item: (item[0].lower(), item[1] or ""))
def make_options(browser_name, browser_version):
# 每种浏览器使用自己的 Options 类,由其提供正确的 browserName。
key = browser_name.lower()
if key == "chrome":
options = webdriver.ChromeOptions()
elif key == "firefox":
options = webdriver.FirefoxOptions()
elif key in {"edge", "microsoftedge"}:
options = webdriver.EdgeOptions()
else:
pytest.skip(f"unsupported browser in this lesson: {browser_name}")
# 只有 Grid 明确公布版本时才做精确版本匹配。
if browser_version:
options.browser_version = browser_version
label = browser_version or "any"
options.set_capability("se:name", f"matrix-{key}-{label}")
return options
@pytest.mark.parametrize("browser_name,browser_version", discover_targets())
def test_same_ui_contract(browser_name, browser_version):
options = make_options(browser_name, browser_version)
driver = webdriver.Remote(command_executor=GRID_URL, options=options)
try:
# 固定 data: 页面使差异只来自浏览器实现,而不是外部站点。
driver.get(
"data:text/html,<title>Cross Browser</title>"
"<button id='save'>Save</button>"
)
assert driver.title == "Cross Browser"
assert driver.find_element(By.ID, "save").is_displayed()
actual = driver.capabilities
print(f"PASS {actual['browserName']} {actual['browserVersion']}")
finally:
driver.quit()预期结果:每个受支持槽位执行同一条 test_same_ui_contract,并打印真实浏览器版本。若当前 Grid 只有 Chrome 与 Firefox,输出形态类似:
PASS chrome <CHROME_VERSION>
PASS firefox <FIREFOX_VERSION>
2 passed in <TIME>s运行并核对实际能力
把代码保存为 test_cross_browser.py 后执行 pytest。-s 保留脚本打印的实际能力,-q 减少无关测试框架输出;验收时不能只看“测试通过”,还要核对打印出的浏览器和版本是否与目标矩阵一致。
python -m pytest -q -s test_cross_browser.py预期结果:每个发现到的 Chrome、Firefox 或 Edge 版本各产生一次 PASS,最终显示 <COUNT> passed in <TIME>s。如果 Grid 注册 3 个不同组合,就应看到 3 次 PASS 和 3 passed;数量不一致时应先回查 /status,而不是修改断言让测试“变绿”。
生产 CI 中更适合把目标矩阵固定在版本化配置里,例如明确要求“Chrome 当前稳定版 + Firefox 当前稳定版 + 一个上一代 Chrome”。自动发现适合本地学习和 Grid 健康检查,但若环境悄悄少了一个 Node,它也会把矩阵缩小,因此不能替代 CI 的必测清单。
处理版本不匹配
当 browserVersion 没有任何槽位可满足时,Grid 会把新会话留在队列中,最终因请求超时失败。不要把这种错误当成页面用例失败;先检查“测试要求什么版本”和“Grid 实际提供什么版本”是否一致。
| 现象 | 根因判断 | 修复 |
|---|---|---|
| 创建会话等待约 30 秒后失败 | 版本或浏览器无可匹配槽位 | 用 /status 核对 stereotype,修正矩阵或补 Node |
| Chrome 通过、Firefox 失败在页面断言 | 环境匹配成功,属于浏览器行为差异 | 保留失败证据,检查 DOM、事件与等待条件 |
| PASS 数量突然减少 | Grid 注册的组合减少 | 把期望矩阵固定到 CI 配置,并在执行前做槽位校验 |
| 实际版本与期望版本不同 | 请求没有设置版本或矩阵写错 | 设置 options.browser_version,并断言 driver.capabilities["browserVersion"] |
跨浏览器测试的通过标准应同时包含业务断言和环境断言:页面行为正确只是第一层,实际 browserName、browserVersion 也必须落在计划矩阵中,否则一次“通过”可能根本没有覆盖你以为覆盖的浏览器版本。