React / 系统课时
React 测试思路
React 测试思路
可靠的组件测试不应该证明内部 state 如何变化,而应该证明用户能找到控件、完成操作并看到正确结果。本节用一个最小测试建立这种思路:从可观察行为写断言,优先使用无障碍角色查询,并把异步等待和 Mock 控制在真正的系统边界上。
学习目标
- 把组件需求改写成用户能够观察到的测试行为。
- 使用 Testing Library 的角色查询和真实交互方式编写测试。
- 区分稳定的行为断言与容易随重构失效的实现细节断言。
先把需求写成用户行为
假设需求是“点击加入购物车后显示成功提示”。测试真正关心的是两个可观察事实:页面存在可点击的“加入购物车”按钮,以及点击后页面出现“已加入购物车”。至于组件内部使用一个布尔值、Reducer 还是状态机,并不是这条需求要求保证的契约。
因此,测试可以按照“找到用户能看到的入口 → 执行用户动作 → 检查用户能看到的结果”组织。这样即使后续重构内部状态,只要行为没有变化,测试通常仍然有效。
用角色查询和真实交互写主测试
下面示例使用 Vitest、@testing-library/react 和 @testing-library/user-event。测试文件通过环境指令使用 jsdom,组件直接定义在同一文件中,因此除测试依赖外不需要额外业务文件。
// @vitest-environment jsdom
import { useState } from "react";
import { render, screen } from "@testing-library/react";
import userEvent from "@testing-library/user-event";
import { expect, test } from "vitest";
function CartButton() {
const [added, setAdded] = useState(false);
return (
<section>
<button onClick={() => setAdded(true)}>加入购物车</button>
{added && <p role="status">已加入购物车</p>}
</section>
);
}
test("点击加入购物车后显示成功提示", async () => {
const user = userEvent.setup();
render(<CartButton />);
// 通过用户可识别的角色和名称定位按钮,而不是依赖 className。
await user.click(screen.getByRole("button", { name: "加入购物车" }));
expect(screen.getByRole("status").textContent).toBe("已加入购物车");
});在已经安装相关依赖的项目中执行:
npx vitest run CartButton.test.tsx预期输出类似:
✓ CartButton.test.tsx > 点击加入购物车后显示成功提示
Test Files 1 passed
Tests 1 passed耗时、文件路径和终端格式会随 Vitest 版本与项目配置变化,但关键结果应是测试文件和测试用例均通过。
优先断言稳定的外部契约
getByRole 通常比 CSS 选择器、组件实例或测试专用 ID 更接近真实用户。按钮、输入框、对话框和状态提示都应优先通过语义角色及可访问名称定位;只有页面确实没有更合适的语义入口时,才考虑 data-testid。
容易变脆的测试通常直接断言内部实现,例如“点击后某个 useState 必须变成 true”“某个内部函数必须调用一次”或“元素必须拥有某个仅用于样式的类名”。这些细节可能在正常重构时变化,却没有改变用户体验。
相对稳定的断言包括可见文本、按钮是否可用、表单错误是否出现、异步数据是否展示以及导航结果是否正确。它们描述的是产品行为,因此测试失败时也更容易判断真正坏掉了什么。
异步测试只等待真正会异步发生的结果
如果结果要等接口响应、定时器或异步状态更新后才出现,应使用 findByRole、findByText 或必要的 waitFor。同步出现的元素则直接使用 getByRole,不要为了消除警告给所有断言都加等待。
Mock 也应该尽量放在系统边界。例如组件依赖 HTTP 数据时,可以替换网络层返回值,而不是 Mock 子组件的每一个内部函数。这样既能让测试保持可控,又不会把组件的具体实现结构复制到测试代码中。
一条有价值的 React 测试应该能回答一个明确问题:用户完成某个操作后,界面是否表现正确。只要持续围绕这个问题选择查询方式、交互和断言,测试就更能承受重构,也更接近真实的回归保护。