You need to enable JavaScript to run this app. React测试中如何正确使用act解决状态更新警告与异步测试问题
优惠活动
大模型
产品
解决方案
定价
更多

React测试中如何正确使用act解决状态更新警告与异步测试问题

问题根因

两个看似矛盾的异常本质上都是act包裹的边界没有对齐React 17的异步更新调度规则:

  • 残留act警告的原因:点击搜索后触发的异步fetch、后续的loading状态切换、结果赋值这些状态更新,没有被纳入act的追踪范围。当这些更新发生在act的作用域外,React就会抛出对应的警告
  • 搜索关键词丢失的原因:拆分act块的时候,没有等待输入触发的内部state更新完全完成,就触发了按钮点击流程。这时候按钮读取的组件内部关键词值还是初始空值,拼到请求地址上自然和测试输入对不上,断言就会失败
  • 额外注意:@wojtekmaj/enzyme-adapter-react-17 必须配合React原生的act方法(从react-dom/test-utils导入),用Enzyme自带的wrapper上的act方法没法正确追踪跨异步任务的状态更新,很容易出现边界错位
可落地的编写逻辑
  • 初始组件挂载流程用await act(async () => { ... })包裹,等所有初始渲染的状态更新完成后再拿到可用的wrapper
  • 输入关键词的模拟操作单独放在一个异步act块里,等change事件触发的内部state更新(把input值同步到组件状态)完全跑完,再退出这个块
  • 搜索按钮的点击操作单独放在另一个异步act块里,块内自然等所有fetch的Promise链执行完成,让后续的状态更新(loading赋值、查询结果赋值)都留在act的追踪范围内
  • 等所有act块执行完成后,再读取mock的fetch调用参数做断言,这时候拿到的就是组件状态更新完成后拼接的正确请求地址
常见踩坑写法对照

把输入、点击全塞进同一个同步act块

act(() => {
  wrapper.find('input').simulate('change', { target: { value: '测试' } });
  wrapper.find('button').simulate('click');
});

实际表现:change事件触发的state更新还在React的同步批处理队列里没执行,按钮点击时读到的关键词值还是空的,请求参数自然不对

等待异步流程但没有把状态更新纳入act追踪

wrapper.find('input').simulate('change', ...);
wrapper.find('button').simulate('click');
await new Promise(r => setTimeout(r, 0));

实际表现:所有异步触发的状态更新都在act作用域外执行,直接触发React的act警告

可正常运行的测试代码参考
import { mount } from 'enzyme';
import { act } from 'react-dom/test-utils';
import Example from './Example';

// 全局mock fetch接口
global.fetch = jest.fn().mockResolvedValue({
  json: jest.fn().mockResolvedValue({ list: [] })
});

describe('Example 组件搜索功能', () => {
  beforeEach(() => {
    fetch.mockClear();
  });

  it('输入关键词后点击搜索,请求地址正确携带关键词', async () => {
    let wrapper;
    // 挂载组件
    await act(async () => {
      wrapper = mount(<Example />);
    });
    wrapper.update();

    // 输入关键词
    await act(async () => {
      wrapper.find('input').simulate('change', {
        target: { value: 'React 测试' }
      });
    });
    wrapper.update();

    // 触发搜索
    await act(async () => {
      wrapper.find('button').simulate('click');
    });

    // 校验请求地址
    expect(fetch).toHaveBeenCalledWith(
      expect.stringContaining('keyword=React 测试')
    );
  });
});

内容的提问来源于stack exchange,提问作者TMH

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.01 14:24:03