自动化测试 / 系统课时

测试组件独立状态

测试组件独立状态

组件测试要把注意力放在组件自己的输入、交互和可观察状态上,而不是依赖整页路由、后端数据或其他组件。本课用一个最小按钮组件演示如何隔离初始输入,触发用户操作,并分别断言默认、点击后、视觉变化和禁用状态。

学习目标

  • 用最小测试页面隔离组件依赖,减少无关失败
  • 按“输入 → 交互 → 可见状态”组织组件测试
  • 分开验证行为状态与稳定的视觉状态

独立测试先控制输入边界

一个组件通常由 props、属性、文本或预置数据决定初始状态。独立测试应主动固定这些输入,再只保留完成行为所需的最小 DOM。这样即使完整应用的路由、接口或全局状态暂时不可用,组件本身的行为仍能被单独验证。

对于浏览器层测试,可以用组件测试框架直接挂载组件,也可以像下面这样用 page.setContent() 构造最小可运行页面。后者不依赖前端构建工具,适合先练习“状态隔离”这个测试思路。

用最小页面覆盖关键状态

示例中的保存按钮初始文案为 Save,点击后变为 Saved,同时切换到绿色背景;另一个按钮保持禁用。断言分别覆盖初始输入、用户交互、可见文案、视觉状态和不可交互状态。

ts
import { test, expect } from '@playwright/test';

test('button component exposes independent states', async ({ page }) => {
  await page.setContent(`
    <style>
      #save.saved { background-color: rgb(0, 128, 0); color: white; }
    </style>
    <button id="save">Save</button>
    <button id="disabled" disabled>Delete</button>
    <script>
      document.querySelector('#save').addEventListener('click', event => {
        event.currentTarget.textContent = 'Saved';
        event.currentTarget.classList.add('saved');
      });
    </script>
  `);

  const saveButton = page.getByRole('button', { name: 'Save' });
  await expect(saveButton).toBeEnabled();
  await saveButton.click();

  const savedButton = page.getByRole('button', { name: 'Saved' });
  await expect(savedButton).toBeVisible();
  await expect(savedButton).toHaveCSS('background-color', 'rgb(0, 128, 0)');

  const disabledButton = page.getByRole('button', { name: 'Delete' });
  await expect(disabledButton).toBeDisabled();
});

预期结果:将代码保存为 component-state.spec.ts 后执行下面的测试命令,交互、视觉状态和禁用状态断言都应通过。

bash
npx playwright test component-state.spec.ts

预期输出:

text
1 passed

如果测试运行器还输出项目名、耗时或 worker 信息,它们属于环境差异;核心验收结果仍是这一条测试通过。

优先断言用户可观察结果

优先使用 getByRole()、toBeVisible()、toBeEnabled() 和 toBeDisabled() 这类面向用户的断言。它们描述用户真正看到或能够操作的状态,比检查事件监听器数量或框架私有字段更稳定。

视觉属性只断言真正属于组件契约的部分。本例明确把绿色背景当作“保存成功”的状态,因此检查 background-color 有意义;如果颜色只是临时设计细节,更适合交给专门的视觉回归测试,而不是让行为测试绑定到它。

隔离测试的停止边界

独立测试不等于把所有依赖都 mock 掉。组件若必须通过真实路由、上下文或网络状态才能成立,应在更高层级的页面测试中覆盖那部分协作;组件测试只保留自身可控的输入和结果。

输入固定、依赖可控、交互明确、结果可观察时,失败范围就能压缩到组件自身。这样既能快速判断是组件逻辑、状态样式还是禁用规则出错,也不会因为整页其他区域变化而产生无关失败。

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

目录与阅读设置

阅读设置

17

记录一个想法

测试组件独立状态

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

登录哪都通