自动化测试 / 系统课时

搭建可维护测试架构

搭建可维护测试架构

当 Selenium 用例从几条增长到几十条后,定位器、浏览器生命周期、环境地址和测试数据如果混在同一文件里,任何页面改动都会造成连锁修改。本篇搭出一个可直接运行的最小工程,把这些变化拆到 Page Object、fixture、配置和数据模块中。

学习目标

  • 按职责拆分 pages、tests、配置与数据模块,保持依赖方向清晰。
  • 用 pytest fixture 统一创建和销毁 WebDriver,会话之间不共享状态。
  • 运行一个参数化用例,验证页面对象、配置和数据能够协同工作。

用四层职责切开变化

一个实用的边界是:测试文件只描述业务场景和断言,Page Object 只封装定位器与页面操作,fixture 管理浏览器资源,配置与数据模块提供可替换输入。这样页面改 ID 时主要改 pages,测试环境地址变化时只改配置。

路径 只负责什么 不应该放什么
config.py 环境地址、等待时间等运行参数 页面定位器
data/cases.py 参数化输入和期望值 WebDriver 调用
pages/dynamic_page.py 定位器、页面动作、页面级等待 业务断言
tests/conftest.py fixture、浏览器创建与回收 业务场景
tests/test_dynamic.py 场景编排与断言 重复定位细节

可维护 Selenium 测试架构中的模块职责与依赖方向

这个结构不要求“每个页面一个巨型类”。页面里的稳定公共组件可以再拆成组件对象,但测试仍应通过清晰的业务方法调用它们,而不是回到测试文件里直接散写 CSS 或 XPath。

建立配置与数据入口

下面文件共同组成一个可运行项目;单个文件属于片段示例,需按给定路径一起保存。前提是本机已有 Python 3.11+ 与 Chrome。先用 requirements.txt 固定主版本范围,避免团队成员各自安装完全不同的依赖。

requirements.txt:

text
selenium>=4.25,<5
pytest>=8,<10

安装并验证依赖:

bash
python -m pip install -r requirements.txt
python -c "import selenium, pytest; print('deps-ok')"

预期输出:

text
<PIP_OUTPUT>
deps-ok

<PIP_OUTPUT> 代表 pip 根据当前环境产生的安装日志,只要最后打印 deps-ok 且命令退出码为 0 即通过。

config.py:

python
from dataclasses import dataclass
import os

@dataclass(frozen=True)
class Settings:
    base_url: str
    wait_seconds: float

    @classmethod
    def from_env(cls) -> "Settings":
        return cls(
            base_url=os.getenv(
                "E2E_BASE_URL",
                "https://www.selenium.dev/selenium/web/dynamic.html",
            ),
            wait_seconds=float(os.getenv("E2E_WAIT_SECONDS", "5")),
        )

data/cases.py:

python
BOX_CASES = [
    {"box_index": 0, "expected_class": "redbox"},
]

这里把默认地址和等待上限集中到 Settings。CI 中可通过环境变量覆盖地址,例如把 E2E_BASE_URL 指向测试环境,而无需修改测试代码;数据模块则只保存输入和期望值,不持有浏览器对象。

把页面行为封装进 Page Object

pages/dynamic_page.py 把“点击添加按钮并等待目标方块出现”包装成页面行为。定位器集中保存,调用方不需要知道页面使用哪个 ID。

python
from selenium.webdriver.common.by import By
from selenium.webdriver.support import expected_conditions as EC
from selenium.webdriver.support.ui import WebDriverWait

class DynamicPage:
    ADD_BUTTON = (By.ID, "adder")

    def __init__(self, driver, wait_seconds: float):
        self.driver = driver
        self.wait = WebDriverWait(driver, wait_seconds)

    def open(self, url: str) -> "DynamicPage":
        self.driver.get(url)
        return self

    def add_box(self, index: int):
        self.wait.until(EC.element_to_be_clickable(self.ADD_BUTTON)).click()
        locator = (By.ID, f"box{index}")
        return self.wait.until(EC.presence_of_element_located(locator))

这个对象返回已经满足页面条件的 WebElement,但不在类里写 assert。业务是否正确由测试决定,这能避免页面对象同时承担“操作页面”和“判定测试成败”两种职责。

用 fixture 驱动用例并验收

tests/conftest.py 统一创建浏览器。fixture 使用 yield,测试结束后无论断言成功还是失败,都执行 quit() 回收整个会话。

python
import pytest
from selenium import webdriver
from selenium.webdriver.chrome.options import Options

from config import Settings

@pytest.fixture(scope="session")
def settings():
    return Settings.from_env()

@pytest.fixture
def driver():
    options = Options()
    options.add_argument("--headless=new")
    browser = webdriver.Chrome(options=options)
    yield browser
    browser.quit()

tests/test_dynamic.py 只保留场景编排和业务断言,测试数据通过 pytest.mark.parametrize 注入。

python
import pytest

from data.cases import BOX_CASES
from pages.dynamic_page import DynamicPage

@pytest.mark.parametrize("case", BOX_CASES)
def test_add_box(driver, settings, case):
    page = DynamicPage(driver, settings.wait_seconds)
    box = page.open(settings.base_url).add_box(case["box_index"])

    actual_class = box.get_dom_attribute("class")
    print(f"box{case['box_index']} class={actual_class}")
    assert actual_class == case["expected_class"]

从项目根目录执行:

bash
python -m pytest -q -s

预期输出:

text
box0 class=redbox
.
1 passed in <TIME>s

<TIME> 会随机器和网络变化。验收时还应确认测试结束后没有遗留 Chrome 进程;如果把 driver 改成 session 级共享 fixture,虽然启动更快,却会让 Cookie、窗口和页面状态跨用例泄漏,通常不适合作为默认方案。

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

目录与阅读设置

阅读设置

17

记录一个想法

搭建可维护测试架构

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

登录哪都通