You need to enable JavaScript to run this app. 如何配置Jest适配Expo、Web多导入项目并解决import语句解析报错
优惠活动
大模型
产品
解决方案
定价
更多

如何配置Jest适配Expo、Web多导入项目并解决import语句解析报错

Expo+Web 全场景适配Jest运行配置

报错本质原因

出现Cannot use import statement outside a module的核心触发点有两个:

  • Jest默认以CommonJS规范解析代码,未对包含ESM语法的源文件、Expo生态第三方依赖做语法转译,直接读取原生import语句就会抛出语法错误
  • 自定义配置中的transformIgnorePatterns规则通常错误将node_modules下的Expo相关包排除在转译范围外,导致这些包的原生ESM语法未被处理就进入解析流程

第一步:安装必备依赖

以下包均为开发环境依赖,安装完成后无需额外配置babel预设即可匹配Expo项目语法解析要求:

  • 核心适配包:jest-expo(Expo官方维护的Jest预设,内置全生态的路径映射、转译规则)
  • 测试工具链:jest、babel-jest、@testing-library/jest-native、@testing-library/react-native、identity-obj-proxy

第二步:直接替换package.json中的Jest配置段

{
  "jest": {
    "preset": "jest-expo",
    "verbose": true,
    "testEnvironment": "jsdom",
    "moduleFileExtensions": [
      "ts",
      "tsx",
      "js",
      "jsx",
      "json",
      "node"
    ],
    "moduleNameMapper": {
      "\\.(jpg|jpeg|png|gif|eot|otf|webp|svg|ttf|woff|woff2|mp4|webm|wav|mp3)$": "<rootDir>/jest/fileMock.js",
      "\\.(css|less|scss|sass)$": "identity-obj-proxy"
    },
    "transformIgnorePatterns": [
      "node_modules/(?!((jest-)?react-native|@react-native(-community)?|expo(nent)?|@expo(nent)?/.*|@expo/vector-icons|expo-.*|@react-navigation/.*)/)"
    ],
    "setupFilesAfterEnv": [
      "<rootDir>/jest/setup.js",
      "@testing-library/jest-native/extend-expect"
    ]
  }
}

配套文件准备

在项目根目录新建jest文件夹,放入两个基础配置文件,解决静态资源、原生API的测试适配问题:

  1. jest/fileMock.js:用于处理所有静态资源导入占位,避免资源文件解析报错,内容为:
    module.exports = 'test-file-stub'
    
  2. jest/setup.js:用于轻量mock Expo生态中依赖原生能力的模块,避免测试运行时触发原生平台API报错,示例内容为:
    // mock expo-av模块
    jest.mock('expo-av', () => ({
      Audio: {
        Sound: {
          createAsync: jest.fn(() => Promise.resolve({ sound: {} }))
        }
      }
    }))
    // mock expo-image-picker模块
    jest.mock('expo-image-picker', () => ({
      launchImageLibraryAsync: jest.fn(() => Promise.resolve({ canceled: true })),
      requestMediaLibraryPermissionsAsync: jest.fn(() => Promise.resolve({ granted: true }))
    }))
    

常见残留问题排查

  • 如果运行测试时仍提示某个第三方包存在import语法无法解析,直接将该包的匹配规则加入transformIgnorePatterns的排除列表即可,不要将全量node_modules纳入转译范围,会大幅拖慢测试启动速度
  • 保持项目package.json不设置"type": "module"配置,Jest对原生全量ESM的支持目前稳定性不足,通过babel将ESM语法转译为CommonJS是Expo项目的最稳定适配方案

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.11.06 02:27:04