如何配置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的测试适配问题:
jest/fileMock.js:用于处理所有静态资源导入占位,避免资源文件解析报错,内容为:module.exports = 'test-file-stub'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
相关产品推荐
相关产品推荐

