React Testing Library 中 act 函数弃用问题的分析与解决方案

背景介绍

在 React 18.3 版本中，React 团队对测试相关的 API 进行了一些调整，其中一个显著变化是对 act 函数的更新。React Testing Library 作为 React 生态中广泛使用的测试工具，需要适配这些变更以确保开发者体验的一致性。

问题现象

当开发者将 React 升级到 18.3 版本后，从 React Testing Library 导入的 act 函数会被标记为已弃用(deprecated)。TypeScript 会显示警告信息："The signature (callback: () => VoidOrUndefinedOnly): void of act is deprecated"。

技术分析

这个问题源于 React Testing Library 的类型定义文件没有完全适配 React 18.3 的新类型。具体表现为：

1. 在 JavaScript 代码层面，React Testing Library 已经正确地导出了 React 18.3 的新版 act 函数
2. 但在类型定义文件(index.d.ts)中，仍然保留了旧版的类型定义
3. 类型定义没有考虑 React 18.3 中 React.act 的存在情况

解决方案

React Testing Library 维护团队提出了以下修复方案：

1. 更新类型定义，优先使用 React 18.3 提供的 React.act 类型
2. 简化类型条件判断，因为 React Testing Library 的 peerDependency 已经要求 React 18+

修正后的类型定义应该类似于：

export const act: typeof reactAct extends undefined ? typeof reactDomTestUtilsAct : typeof reactAct

对开发者的影响

1. 对于使用 React 18.3+ 的开发者，更新后将不再看到弃用警告
2. 测试代码的行为不会发生变化，只是类型检查更加准确
3. 开发者可以继续使用熟悉的 act 模式编写测试

最佳实践建议

1. 保持 React Testing Library 和 React 版本的同步更新
2. 关注测试中的弃用警告，及时调整代码
3. 理解 act 在 React 18+ 中的行为变化，特别是与并发渲染相关的场景

总结

React 生态系统的持续演进要求配套工具链也需要相应调整。React Testing Library 团队积极跟进 React 18 的变化，确保开发者能够平滑过渡到新版本。这个问题也提醒我们，在升级主要依赖时，需要同时关注相关工具链的兼容性更新。