自动化测试 / 系统课时

配置跨浏览器测试

配置跨浏览器测试

本课把同一条 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 秒,便于本地排错。

bash
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 记录真实版本。这样同一份断言无需复制。

python
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,输出形态类似:

text
PASS chrome <CHROME_VERSION>
PASS firefox <FIREFOX_VERSION>
2 passed in <TIME>s

运行并核对实际能力

把代码保存为 test_cross_browser.py 后执行 pytest。-s 保留脚本打印的实际能力,-q 减少无关测试框架输出;验收时不能只看“测试通过”,还要核对打印出的浏览器和版本是否与目标矩阵一致。

bash
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 也必须落在计划矩阵中,否则一次“通过”可能根本没有覆盖你以为覆盖的浏览器版本。

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

目录与阅读设置

阅读设置

17

记录一个想法

配置跨浏览器测试

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

登录哪都通