React / 系统课时

React 测试思路

React 测试思路

可靠的组件测试不应该证明内部 state 如何变化,而应该证明用户能找到控件、完成操作并看到正确结果。本节用一个最小测试建立这种思路:从可观察行为写断言,优先使用无障碍角色查询,并把异步等待和 Mock 控制在真正的系统边界上。

学习目标

  • 把组件需求改写成用户能够观察到的测试行为。
  • 使用 Testing Library 的角色查询和真实交互方式编写测试。
  • 区分稳定的行为断言与容易随重构失效的实现细节断言。

先把需求写成用户行为

假设需求是“点击加入购物车后显示成功提示”。测试真正关心的是两个可观察事实:页面存在可点击的“加入购物车”按钮,以及点击后页面出现“已加入购物车”。至于组件内部使用一个布尔值、Reducer 还是状态机,并不是这条需求要求保证的契约。

因此,测试可以按照“找到用户能看到的入口 → 执行用户动作 → 检查用户能看到的结果”组织。这样即使后续重构内部状态,只要行为没有变化,测试通常仍然有效。

用角色查询和真实交互写主测试

下面示例使用 Vitest、@testing-library/react 和 @testing-library/user-event。测试文件通过环境指令使用 jsdom,组件直接定义在同一文件中,因此除测试依赖外不需要额外业务文件。

tsx
// @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("已加入购物车");
});

在已经安装相关依赖的项目中执行:

bash
npx vitest run CartButton.test.tsx

预期输出类似:

text
✓ 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 测试应该能回答一个明确问题:用户完成某个操作后,界面是否表现正确。只要持续围绕这个问题选择查询方式、交互和断言,测试就更能承受重构,也更接近真实的回归保护。

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

目录与阅读设置

阅读设置

17

记录一个想法

React 测试思路

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

登录哪都通