自动化测试 / 系统课时

搭建可维护测试架构

搭建可维护测试架构

当用例从几个文件增长到几十个时,真正拖慢维护的通常不是断言,而是登录逻辑、定位器、环境地址和测试数据散落在各处。本节把 Fixture、页面对象、配置和数据模块组合成一套职责清晰、可扩展的 Playwright 测试架构。

学习目标

  • 划分测试、Fixture、页面对象、配置和测试数据的职责边界
  • 使用 test.extend() 把页面对象注入测试,减少重复初始化代码
  • 建立能随页面和场景增长而保持稳定的项目组织方式

先划清职责边界

可维护架构的核心不是“文件越多越专业”,而是变化发生时只改最相关的一层。测试文件描述业务意图和断言;页面对象封装定位器与页面操作;Fixture 负责对象创建和生命周期;配置集中环境级参数;数据模块只保存或生成测试输入。

Playwright 可维护测试架构的职责关系

这样分层后,按钮改名主要影响页面对象,测试环境切换主要影响配置,测试账号变化主要影响数据或专用 Fixture。测试本身应尽量保留“登录后看到仪表盘”这样的业务语义,而不是塞满定位器和初始化细节。

搭出最小可维护骨架

下面示例假设被测应用提供 /login,表单标签为 Email 和 Password,登录成功后出现 Dashboard 标题。账号需要事先存在于测试环境;示例中的 .test 域名和密码只用于演示,不应替换生产凭据。

playwright.config.ts 只保存跨测试共享的运行参数,不写具体页面选择器或业务数据。

ts
import { defineConfig } from '@playwright/test';

export default defineConfig({
  testDir: './tests',
  use: {
    // 环境地址允许由 CI 覆盖,本地保留稳定默认值。
    baseURL: process.env.APP_BASE_URL ?? 'http://127.0.0.1:3000',
    trace: 'on-first-retry',
  },
});

生效行为:page.goto('/login') 会基于 baseURL 解析完整地址;CI 可通过 APP_BASE_URL 切换目标环境。可用后文的测试命令验证配置是否正常加载。

tests/data/users.ts 是项目文件示例,不独立运行。它只描述测试输入,不负责登录动作。

ts
export const users = {
  // 真实项目应使用测试环境专用账号,避免提交生产秘密。
  admin: {
    email: 'admin@example.test',
    password: 'P@ssw0rd!',
  },
} as const;

生效行为:测试通过 users.admin 获取稳定输入;更换账号或增加角色时,不需要修改页面对象中的操作逻辑。

tests/pages/login.page.ts 把定位器和页面动作收在同一处,让选择器变化不会扩散到所有测试。

ts
import type { Locator, Page } from '@playwright/test';

type Credentials = {
  email: string;
  password: string;
};

export class LoginPage {
  private readonly emailInput: Locator;
  private readonly passwordInput: Locator;

  constructor(private readonly page: Page) {
    // 定位策略留在页面对象内部,测试只调用业务动作。
    this.emailInput = page.getByLabel('Email');
    this.passwordInput = page.getByLabel('Password');
  }

  async goto(): Promise<void> {
    await this.page.goto('/login');
  }

  async login(user: Credentials): Promise<void> {
    await this.emailInput.fill(user.email);
    await this.passwordInput.fill(user.password);
    await this.page.getByRole('button', { name: 'Sign in' }).click();
  }
}

生效行为:测试只需要调用 goto() 和 login();如果表单定位方式变化,只需调整这个页面对象。

tests/fixtures/app.fixture.ts 用 test.extend() 注入页面对象。Fixture 管理依赖创建,不需要手工关闭内置 page,Playwright 会在测试结束后处理它的生命周期。

ts
import { test as base, expect } from '@playwright/test';
import { LoginPage } from '../pages/login.page';

type AppFixtures = {
  loginPage: LoginPage;
};

export const test = base.extend<AppFixtures>({
  // 只有声明了 loginPage 的测试才会准备这个 Fixture。
  loginPage: async ({ page }, use) => {
    await use(new LoginPage(page));
  },
});

export { expect };

生效行为:测试函数声明 loginPage 后,Playwright 自动创建并注入实例;未使用该 Fixture 的测试不会执行这段初始化。

最后,tests/login.spec.ts 只组合业务步骤、测试数据和结果断言。

ts
import { test, expect } from './fixtures/app.fixture';
import { users } from './data/users';

test('管理员可以登录', async ({ loginPage, page }) => {
  await loginPage.goto();
  await loginPage.login(users.admin);

  // 核心业务结果保留在测试中,阅读时能直接看到验收条件。
  await expect(page.getByRole('heading', { name: 'Dashboard' })).toBeVisible();
});

预期结果:在满足前述页面契约且测试账号有效时,Fixture 会为该用例创建 LoginPage,页面对象完成登录,最终由测试断言仪表盘标题可见。

运行这条用例:

bash
npx playwright test tests/login.spec.ts

预期输出:

text
Running 1 test using 1 worker
  ✓ 管理员可以登录
  1 passed (<TIME>)

实际耗时和报告中的文件行号可能不同,因此用 <TIME> 表示动态值。

让扩展点保持单一职责

新增“订单页”时,优先增加 OrderPage,再按需由 Fixture 注入;不要继续把订单定位器塞进 LoginPage。如果数据需要动态创建,可以把用户构造器或订单工厂放到数据模块;如果创建过程需要网络资源,再升级为独立 Fixture。

Fixture 也不应变成万能 beforeEach。只有用例声明所需 Fixture 时才准备依赖,可以减少无关初始化。昂贵资源若确实能安全共享,再评估 worker 级 Fixture;会被测试修改的浏览器状态和业务数据通常仍应保持测试隔离。

避开失控架构

常见失控信号包括:测试文件直接出现大量 CSS/XPath、页面对象读取环境变量、配置文件保存业务账号、Fixture 自动执行所有登录和建数步骤。它们都会让依赖方向反转,使一次小改动影响多个层次。

判断是否分层合理,可以用一个简单标准:一个变化是否能在最接近它的模块中被吸收。页面结构变了主要改 Page Object,环境变了主要改配置,输入变了主要改数据,业务预期变了主要改测试;满足这个条件,架构才是在降低维护成本,而不是单纯增加文件。

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

目录与阅读设置

阅读设置

17

记录一个想法

搭建可维护测试架构

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

登录哪都通