React / 系统课时
模拟用户交互
模拟用户交互
点击事件并不只是一条 click 回调,真实用户操作还包含聚焦、键盘输入、表单校验和异步更新。本课使用 user-event 按操作顺序驱动组件,验证输入、提交、防重复点击和成功反馈是否协同工作。
学习目标
- 使用
userEvent.setup()模拟真实交互 - 正确等待输入、点击和异步页面更新
- 通过回调替身验证提交参数与按钮状态
为什么优先使用 user-event
fireEvent 可以直接派发底层事件,适合少数需要精确构造事件对象的场景。user-event 会执行更接近浏览器的交互序列,例如点击前检查元素是否可交互,输入时触发聚焦、键盘和输入事件,因此更适合描述用户行为。
多数 user-event 操作返回 Promise,应使用 await。忘记等待可能让断言在状态更新前执行,产生偶发失败。每个测试创建自己的 user 实例,也能避免配置和状态在用例之间相互影响。
测试完整提交流程
下面的登录表单在提交期间禁用按钮,并在异步回调完成后显示欢迎信息。测试不会直接调用 handleSubmit,而是像用户一样填写字段和点击按钮。
// src/LoginForm.tsx
import { type FormEvent, useState } from "react";
type Credentials = {
username: string;
password: string;
};
type Props = {
onLogin: (credentials: Credentials) => Promise<string>;
};
export function LoginForm({ onLogin }: Props) {
const [username, setUsername] = useState("");
const [password, setPassword] = useState("");
const [submitting, setSubmitting] = useState(false);
const [message, setMessage] = useState("");
async function handleSubmit(event: FormEvent) {
event.preventDefault();
setSubmitting(true);
try {
const displayName = await onLogin({ username, password });
setMessage(`欢迎,${displayName}`);
} finally {
setSubmitting(false);
}
}
return (
<form onSubmit={handleSubmit}>
<label>
用户名
<input
value={username}
onChange={(event) => setUsername(event.target.value)}
/>
</label>
<label>
密码
<input
type="password"
value={password}
onChange={(event) => setPassword(event.target.value)}
/>
</label>
<button type="submit" disabled={submitting}>
{submitting ? "登录中..." : "登录"}
</button>
<p role="status">{message}</p>
</form>
);
}// src/LoginForm.test.tsx
import { act, render, screen } from "@testing-library/react";
import "@testing-library/jest-dom/vitest";
import userEvent from "@testing-library/user-event";
import { expect, test, vi } from "vitest";
import { LoginForm } from "./LoginForm";
test("用户填写并提交登录表单", async () => {
const user = userEvent.setup();
let resolveLogin!: (name: string) => void;
const login = vi.fn(
() =>
new Promise<string>((resolve) => {
resolveLogin = resolve;
}),
);
render(<LoginForm onLogin={login} />);
await user.type(screen.getByRole("textbox", { name: "用户名" }), "simon");
await user.type(screen.getByLabelText("密码"), "secret123");
await user.click(screen.getByRole("button", { name: "登录" }));
expect(login).toHaveBeenCalledWith({
username: "simon",
password: "secret123",
});
expect(screen.getByRole("button", { name: "登录中..." })).toBeDisabled();
await act(async () => {
resolveLogin("Simon");
});
expect(await screen.findByText("欢迎,Simon")).toBeInTheDocument();
expect(screen.getByRole("button", { name: "登录" })).toBeEnabled();
});预期结果:测试通过,并确认提交参数正确、请求期间按钮禁用、请求完成后显示欢迎信息。这里手动控制 Promise 完成时机,是为了稳定验证中间状态,不依赖真实网络速度。
稳定交互与常见错误
user.type 适合追加文本,user.clear 用于清空输入框,user.keyboard 可以发送回车、Tab 和组合键。断言应关注用户能观察到的值与结果,而不是检查 onChange 被调用了多少次。
对于表单,点击提交按钮通常比直接派发 submit 更接近真实使用过程,因为浏览器会先处理按钮状态和字段约束。若需求支持按 Enter 提交,也应增加对应的用户路径测试,而不是假设点击用例可以覆盖键盘行为。
稳定测试异步交互
异步断言优先使用 findBy 或 waitFor。不要通过固定等待若干毫秒来“等页面更新”,因为机器负载变化会让测试变慢或偶发失败。测试应等待明确条件,例如按钮重新启用、提示出现或加载元素消失。
还要避免在单个测试中塞入过多无关动作。一个用例应围绕一个用户结果组织;若登录失败、字段校验和成功提交有不同业务含义,应拆成独立用例,失败时更容易定位。
常见错误
不要复用上一个测试留下的 DOM 节点或用户实例。测试工具通常会自动清理渲染结果,但共享可变替身和全局变量仍可能造成污染。每个用例都应创建自己的依赖替身,并明确设置返回值。
不要断言临时实现细节,例如“输入每个字符调用一次函数”。输入法、浏览器行为和组件实现都可能改变调用次数,而最终字段值和提交参数才是稳定的业务结果。