罗罗编程学习记录
本页内容 展开查看

03.13.2 组件测试

所属:全栈开发面试题库 / 03 前端基础与 Web 开发 / 03.13 前端测试

覆盖范围

  • Testing Library:render、screen、queries
  • 用户事件:userEvent、fireEvent、异步等待
  • 可访问性查询:getByRole、getByLabelText
  • 状态与副作用:react-hooks、effect 测试

高频题速览

编号 题目 难度 频率
03.13.2-001 Testing Library 哲学与查询方式 进阶 ★★★★
03.13.2-002 userEvent 与 fireEvent 区别 进阶 ★★★★
03.13.2-003 异步组件如何等待 进阶 ★★★★
03.13.2-004 getByRole 与 getByTestId 取舍 基础 ★★★
03.13.2-005 组件卸载与清理 基础 ★★★
03.13.2-006 如何测试 Context/Provider 进阶 ★★★
03.13.2-007 路由与导航组件测试 进阶 ★★★
03.13.2-008 可视查询与等待元素 进阶 ★★★

03.13.2-001 Testing Library 哲学与查询方式

一句话结论

Testing Library 主张按用户视角查询,优先用 getByRole(可访问性角色),次要用 getByLabelText/getByText,最后才用 getByTestId;不查询组件内部状态。

概念解释

  • 查询优先级:role > labelText > text > testId。
  • 哲学:测试用户行为,不测试实现细节。

原理流程

  1. render 组件。
  2. screen.getByRole 查找。
  3. 模拟用户交互。

代码 / 示例

render(<Button>提交</Button>);
screen.getByRole("button", { name: "提交" });

常见误区

  • 误区:用 data-testid 查所有元素;正解:testId 是最后手段,优先 role。
  • 误区:测试组件内部 state;正解:测试输出与行为,不测试内部。

追问

  • Q:如何找不出 role? A:组件应语义化,或加 aria-label。
  • Q:getBy 与 queryBy 区别? A:getBy 找不到会抛错,queryBy 返回 null。

03.13.2-002 userEvent 与 fireEvent 区别

一句话结论

fireEvent 直接触发 DOM 事件;userEvent 模拟真实用户操作(包括按键、悬停、多步),更贴近用户行为,推荐优先用 userEvent。

概念解释

  • fireEvent:底层事件触发。
  • userEvent:高层模拟。

原理流程

  1. userEvent 内部调用 fireEvent。
  2. 模拟完整交互序列。

代码 / 示例

import userEvent from "@testing-library/user-event";
it("types", async () => {
  render(<Input />);
  await userEvent.type(screen.getByRole("textbox"), "hello");
});

常见误区

  • 误区:fireEvent.click 就够;正解:userEvent.click 更接近真实,包括 focus。
  • 误区:userEvent 不需要 await;正解:userEvent 是异步,必须 await。

追问

  • Q:userEvent v14 变化? A:API 重构,全部异步,按官方文档。
  • Q:如何测试 hover? A:userEvent.hover()。

03.13.2-003 异步组件如何等待

一句话结论

异步组件用 await screen.findByRole(自动等待)或 waitFor 断言;避免固定 setTimeout。

概念解释

  • findBy:queryBy + waitFor。
  • waitFor:轮询等待断言。

原理流程

  1. render 后立即 findBy。
  2. 库自动重试直到超时。

代码 / 示例

render(<UserList />);
await screen.findByRole("listitem", { name: "Ann" });

常见误区

  • 误区:用 setTimeout 等待;正解:findBy/waitFor 自动等待。
  • 误区:等待时间太长;正解:默认 1000ms,可配置 timeout。

追问

  • Q:如何等待多个元素? A:findAllByRole。
  • Q:如何测试 loading 状态? A:先断言 loading 出现,再 findBy 等数据。

03.13.2-004 getByRole 与 getByTestId 取舍

一句话结论

优先 getByRole,因为它要求语义化与可访问性;当元素无 role(如纯展示 div)时用 getByTestId。

概念解释

  • role:可访问性角色。
  • testId:data-testid 属性。

原理流程

  1. role 查询模拟屏幕阅读器。
  2. testId 只在测试中可见。

代码 / 示例

<div data-testid="custom-visual" role="img" aria-label="图表">...</div>

常见误区

  • 误区:所有元素加 testId;正解:testId 是兜底。
  • 误区:role 只能查 button;正解:role 包括 heading、link、textbox、listitem 等。

追问

  • Q:如何知道 role? A:Chrome DevTools Accessibility 面板。
  • Q:aria-label 与 name 关系? A:name 是可访问名,role + name 定位。

03.13.2-005 组件卸载与清理

一句话结论

Testing Library 自动在每个测试后清理渲染的组件;手动 render 需要 cleanup,否则 DOM 残留影响下一个测试。

概念解释

  • cleanup:卸载组件并移除 DOM。
  • 自动清理:Vitest/Jest setup 中配置。

原理流程

  1. 每个测试后 cleanup。
  2. DOM 树清空。

代码 / 示例

import { cleanup } from "@testing-library/react";
afterEach(cleanup);

常见误区

  • 误区:不清理也没事;正解:DOM 残留导致查询找到上一个测试的元素。
  • 误区:自动清理需要配置;正解:vite-plugin-testing 自动配置。

追问

  • Q:如何测试组件卸载副作用? A:在 cleanup 后断言 effect cleanup 被调用。
  • Q:useEffect cleanup? A:render 后 unmount,断言 cleanup 函数执行。

03.13.2-006 如何测试 Context/Provider

一句话结论

测试 Context 时把组件包在 Provider 中,或用 render(ui, { wrapper }) 复用公共 wrapper。

概念解释

  • wrapper:外层组件。
  • Provider:提供 context 值。

原理流程

  1. render 时传 wrapper。
  2. 组件内 useContext 拿到值。

代码 / 示例

render(<MyComponent />, { wrapper: ({ children }) => <ThemeProvider>{children}</ThemeProvider> });

常见误区

  • 误区:直接 render 组件;正解:缺少 Provider 会报错。
  • 误区:每个测试都包 Provider;正解:用自定义 render 函数复用。

追问

  • Q:如何测试 useContext? A:渲染一个消费组件,或用 @testing-library/react-hooks。
  • Q:Provider 动态值? A:在测试中修改 state 重渲染。

03.13.2-007 路由与导航组件测试

一句话结论

路由组件测试用 MemoryRouter 包裹,初始路由通过 initialEntries 设置;断言当前路由渲染的内容。

概念解释

  • MemoryRouter:内存路由,不依赖浏览器 URL。
  • initialEntries:初始历史栈。

原理流程

  1. render 时包 MemoryRouter。
  2. 模拟点击 Link。
  3. 断言新页面渲染。

代码 / 示例

render(
  <MemoryRouter initialEntries={["/home"]}>
    <App />
  </MemoryRouter>
);

常见误区

  • 误区:用真实 BrowserRouter;正解:测试中用 MemoryRouter。
  • 误区:断言 URL 变化;正解:断言渲染的内容。

追问

  • Q:如何测试路由跳转? A:点击 Link,断言新页面标题。
  • Q:Vue Router 测试? A:用 memory history。

03.13.2-008 可视查询与等待元素

一句话结论

用 toBeVisible() 断言元素可见,waitForElementToBeRemoved 等待元素消失;避免断言 style 或 class。

概念解释

  • toBeVisible:元素在 DOM 中且非隐藏。
  • toBeRemoved:元素从 DOM 移除。

原理流程

  1. 断言元素可见。
  2. 触发操作。
  3. 等待元素消失。

代码 / 示例

await waitForElementToBeRemoved(() => screen.getByText("加载中"));
expect(screen.getByRole("alert")).toBeVisible();

常见误区

  • 误区:断言 class="hidden";正解:断言可见性,不关心实现。
  • 误区:等待元素消失用 setTimeout;正解:waitForElementToBeRemoved。

追问

  • Q:如何测试模态框关闭? A:点击关闭,waitForElementToBeRemoved。
  • Q:toBeVisible 来自哪里? A:@testing-library/jest-dom 扩展。

03.13.2-009 如何测试自定义 Hooks

一句话结论

用 renderHook 渲染 Hook,用 act 包裹状态更新,用 result.current 访问返回值;React 18 提供了更友好的 act 提示。

概念解释

  • renderHook:渲染 Hook 而不需要组件。
  • act:确保状态更新被批处理。

原理流程

  1. renderHook(() => useMyHook(initialValue))。
  2. act(() => result.current.update(newValue))。
  3. 断言 result.current.value。

代码 / 示例

import { renderHook, act } from "@testing-library/react";
import { useCounter } from "./useCounter";

it("increments", () => {
  const { result } = renderHook(() => useCounter(0));
  act(() => result.current.increment());
  expect(result.current.count).toBe(1);
});

常见误区

  • 误区:Hook 测试要包组件;正解:renderHook 直接渲染。
  • 误区:状态更新不包 act;正解:会出现 warning,且断言时机不对。

追问

  • Q:如何测试 Hook 依赖变化? A:rerender({ initialProps: ... })。
  • Q:Hook 内异步如何测试? A:用 waitFor 等待 result.current 更新。

待整理清单

  • [ ] 组件样式测试
  • [ ] 视觉快照与组件测试结合
  • [ ] 自定义 render 函数

关联与延伸

  • Testing Library 哲学是"按用户视角测试",与 03.12.3 可访问性理念一致。
  • 组件测试介于单元测试与 E2E 之间,是前端测试金字塔中层。
  • getByRole 优先查询不仅是测试技巧,也是推动组件语义化的手段。

面试准备要点

  • 必须说清 Testing Library 哲学:不测试实现,测试用户行为。
  • 必须说清 userEvent 与 fireEvent 区别:前者更真实,需 await。
  • 常见追问:异步组件如何等待?答:findBy 自动等待。
  • 常见追问:getByRole 与 getByTestId 取舍?答:优先 role。
  • 常见追问:组件卸载清理?答:自动 cleanup,afterEach。
  • 常见追问:Context 如何测试?答:用 wrapper 包裹 Provider。
  • 常见追问:如何测试路由组件?答:MemoryRouter + initialEntries。
  • 常见追问:如何测试 useEffect?答:渲染后断言副作用。
  • 常见追问:userEvent v14 变化?答:全部异步,必须 await。
  • 常见追问:Testing Library 哲学?答:按用户视角测试,不测试实现。
  • 常见追问:getByRole 优先?答:role > labelText > text > testId。
  • 常见追问:异步如何等待?答:findBy 自动等待。
  • 常见追问:组件卸载清理?答:自动 cleanup,afterEach。
  • 常见追问:如何测试 Context/Provider?答:render 时传 wrapper。
  • 常见追问:如何测试路由组件?答:MemoryRouter + initialEntries。
  • 常见追问:如何测试异步等待?答:findBy 自动等待,或 waitFor。
  • 常见追问:如何测试可访问性?答:getByRole 查询,配合 axe。
  • 常见追问:自定义 render 函数?答:复用 Provider 与公共配置。