React Native Testing Library 中解决 Jest 测试的 ES6 模块导出错误

在 React Native 项目中使用 Jest 进行单元测试时，开发者经常会遇到"Unexpected token 'export'"的错误提示。这个问题通常出现在测试环境尝试解析某些依赖库的 ES6 模块语法时，而 Jest 的默认配置未能正确处理这些现代 JavaScript 特性。

问题本质分析

这个错误的根本原因是测试运行环境与项目依赖之间的模块系统不兼容。当 Jest 遇到包含 ES6 模块语法（如 export/import）的第三方库时，如果这些模块没有被正确转换，就会抛出语法错误。在 React Native 生态中，这个问题尤为常见，因为：

1. 许多现代库已经采用纯 ES6 模块格式发布
2. React Native 的测试环境需要特殊配置来处理这些模块
3. Babel 转换规则需要针对测试环境进行优化

关键配置要点

解决这个问题的核心在于正确配置 Jest 的 transformIgnorePatterns 和 Babel 预设。以下是几个关键配置项的技术细节：

1. transformIgnorePatterns：这个配置告诉 Jest 哪些 node_modules 目录下的文件需要被 Babel 转换。默认情况下，Jest 会忽略所有 node_modules 中的文件，这会导致 ES6 语法不被转换。

2. Babel 预设：React Native 项目需要特殊的 Babel 预设 '@react-native/babel-preset'，它包含了处理 React Native 特殊语法和 JSX 的必要插件。

3. 测试环境选择：虽然 React Native 运行在原生环境，但测试通常使用 jsdom 来模拟浏览器环境，这需要额外的兼容性处理。

解决方案实施

针对这类问题，开发者可以采取以下解决方案：

1. 确保使用正确的测试库：React Native 项目应该使用专门为 Native 环境设计的测试库，而不是普通的 React 测试库。

2. 完善 Jest 配置：在 jest.config.js 中，需要精心设计 transformIgnorePatterns 来包含所有需要转换的第三方库。常见的需要特别处理的库包括 react-native、@react-native 等核心依赖。

3. Babel 插件补充：根据项目使用的现代 JavaScript 特性，可能需要添加额外的 Babel 插件来处理类属性、私有方法等语法。

4. 测试环境模拟：对于 React Native 特有的 API，需要在测试启动文件(jestSetup.ts)中进行适当的模拟，避免测试运行时缺少原生模块。

最佳实践建议

为了避免这类问题在日常开发中出现，建议遵循以下实践：

1. 保持测试相关依赖的版本与主项目一致
2. 定期检查并更新 transformIgnorePatterns 中的库列表
3. 为新添加的依赖考虑测试环境的兼容性
4. 建立项目级的测试配置模板，避免重复配置
5. 对于复杂的原生模块，考虑使用适当的模拟实现

通过系统性地理解和应用这些配置原则，开发者可以有效地解决 React Native 测试中的模块语法错误问题，建立起稳定可靠的测试基础设施。