React Native Testing Library 中解决 "Unexpected token 'export'" 错误的完整指南

在使用 React Native Testing Library 进行测试时，开发者经常会遇到 "Unexpected token 'export'" 的错误。这个错误通常发生在 Jest 无法正确处理某些依赖项的 ES6 模块语法时。本文将深入分析这个问题的根源，并提供完整的解决方案。

问题本质分析

这个错误的根本原因是 Jest 的模块转换系统未能正确处理某些依赖项的 ES6 模块导出语法。在 React Native 生态系统中，这通常发生在以下情况：

1. 错误地使用了 @testing-library/react 而不是专为 React Native 设计的 @testing-library/react-native
2. Jest 的 transformIgnorePatterns 配置不当，导致某些依赖项没有被 Babel 转换
3. Babel 配置缺少必要的插件来处理现代 JavaScript 语法

正确的依赖选择

React Native 测试需要使用专门的 @testing-library/react-native 库，而不是常规的 @testing-library/react。这两个库虽然名称相似，但针对不同的平台进行了优化：

• @testing-library/react 适用于 web 环境的 React 应用
• @testing-library/react-native 专门为 React Native 移动应用设计

完整的解决方案

1. 确保使用正确的测试库

首先确认你的 package.json 中包含的是正确的测试库：

"devDependencies": {
  "@testing-library/react-native": "^12.0.0",
  // 其他依赖...
}

2. 优化 Jest 配置

更新你的 jest.config.js 文件，确保包含以下关键配置：

module.exports = {
  preset: 'react-native',
  transformIgnorePatterns: [
    'node_modules/(?!(react-native|@react-native|react-native-webrtc|react-native-reanimated|@react-native-community|@testing-library/react-native|@babel|metro-react-native-babel-preset)/)',
  ],
  // 其他配置...
};

3. 完善 Babel 配置

确保 babel.config.js 包含 React Native 所需的所有预设和插件：

module.exports = {
  presets: ['module:@react-native/babel-preset'],
  plugins: [
    'react-native-reanimated/plugin',
    // 其他插件...
  ],
};

高级故障排除

如果上述方案仍不能解决问题，可以考虑以下进阶方案：

1. 检查具体报错模块：错误信息通常会指出哪个模块导致了问题，可以单独将该模块添加到 transformIgnorePatterns 的例外中

2. 更新依赖版本：确保所有相关依赖都是最新兼容版本

3. 清理缓存：运行 jest --clearCache 清除可能存在的缓存问题

4. 检查 Node 版本：确保使用的 Node.js 版本与 React Native 和 Jest 兼容

最佳实践建议

1. 始终为 React Native 项目使用专门的 @testing-library/react-native

2. 定期更新测试相关依赖，保持生态一致性

3. 在 CI/CD 环境中使用与本地开发相同的 Node 和 npm/yarn 版本

4. 考虑使用 TypeScript 以获得更好的类型安全和早期错误检测

通过遵循这些指导原则，开发者可以有效地解决 "Unexpected token 'export'" 错误，并建立稳定的 React Native 测试环境。记住，正确的工具选择和配置是成功进行 React Native 应用测试的关键。