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。
- 哲学:测试用户行为,不测试实现细节。
原理流程
- render 组件。
- screen.getByRole 查找。
- 模拟用户交互。
代码 / 示例
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:高层模拟。
原理流程
- userEvent 内部调用 fireEvent。
- 模拟完整交互序列。
代码 / 示例
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:轮询等待断言。
原理流程
- render 后立即 findBy。
- 库自动重试直到超时。
代码 / 示例
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属性。
原理流程
- role 查询模拟屏幕阅读器。
- 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 中配置。
原理流程
- 每个测试后 cleanup。
- 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 值。
原理流程
- render 时传 wrapper。
- 组件内 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:初始历史栈。
原理流程
- render 时包 MemoryRouter。
- 模拟点击 Link。
- 断言新页面渲染。
代码 / 示例
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 移除。
原理流程
- 断言元素可见。
- 触发操作。
- 等待元素消失。
代码 / 示例
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:确保状态更新被批处理。
原理流程
- renderHook(() => useMyHook(initialValue))。
- act(() => result.current.update(newValue))。
- 断言 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 与公共配置。