React / 系统课时

模拟用户交互

模拟用户交互

点击事件并不只是一条 click 回调,真实用户操作还包含聚焦、键盘输入、表单校验和异步更新。本课使用 user-event 按操作顺序驱动组件,验证输入、提交、防重复点击和成功反馈是否协同工作。

学习目标

  • 使用 userEvent.setup() 模拟真实交互
  • 正确等待输入、点击和异步页面更新
  • 通过回调替身验证提交参数与按钮状态

为什么优先使用 user-event

fireEvent 可以直接派发底层事件,适合少数需要精确构造事件对象的场景。user-event 会执行更接近浏览器的交互序列,例如点击前检查元素是否可交互,输入时触发聚焦、键盘和输入事件,因此更适合描述用户行为。

多数 user-event 操作返回 Promise,应使用 await。忘记等待可能让断言在状态更新前执行,产生偶发失败。每个测试创建自己的 user 实例,也能避免配置和状态在用例之间相互影响。

测试完整提交流程

下面的登录表单在提交期间禁用按钮,并在异步回调完成后显示欢迎信息。测试不会直接调用 handleSubmit,而是像用户一样填写字段和点击按钮。

tsx
// 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>
  );
}
tsx
// 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 节点或用户实例。测试工具通常会自动清理渲染结果,但共享可变替身和全局变量仍可能造成污染。每个用例都应创建自己的依赖替身,并明确设置返回值。

不要断言临时实现细节,例如“输入每个字符调用一次函数”。输入法、浏览器行为和组件实现都可能改变调用次数,而最终字段值和提交参数才是稳定的业务结果。

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

目录与阅读设置

阅读设置

17

记录一个想法

模拟用户交互

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

登录哪都通