Detox配置触发TS2339错误：jasmine类型不存在getEnv属性

问题触发场景 #

为Detox移动端测试框架编写setup.ts类型配置文件时，运行环节触发TypeScript类型报错：TS2339: Property 'getEnv' does not exist on type 'typeof jasmine'。
当前项目已完成Jest测试框架的依赖安装，初始编写的配置代码如下：

const detox = require('detox');
const adapter = require('detox/runners/jest/adapter');
const specReporter = require('detox/runners/jest/specReporter');

jest.setTimeout(25000); 
jasmine.getEnv().addReporter(adapter)

beforeAll(async () => {
  await detox.init();
  await device.launchApp();
});

beforeEach(async () => {
  await adapter.beforeEach();
});

afterAll(async () => {
  await adapter.afterAll();
  await detox.cleanup();
});

报错核心原因 #

Jest 内置的TypeScript类型声明中，全局jasmine对象的定义未覆盖getEnv方法的类型标注。Detox的Jest运行器适配模块运行时本身依赖Jasmine全局环境的能力，但项目侧未引入对应完整的Jasmine类型声明，导致TS校验阶段无法识别该方法的存在。

解决步骤 #

• 安装Jasmine对应的类型声明依赖：执行命令npm install --save-dev @types/jasmine
• 检查项目根目录下tsconfig.json的compilerOptions.types配置，确保类型解析数组中包含jest、jasmine、node三类核心声明，示例配置片段：

{
  "compilerOptions": {
    "types": ["jest", "jasmine", "node"]
  }
}

• 若完成上述步骤后仍存在类型识别异常，可在setup.ts文件顶部添加显式类型引用，强制TS解析器加载Jasmine类型定义：

/// <reference types="jasmine" />

校验标准 #

调整完成后重新触发TS校验，jasmine.getEnv().addReporter(adapter)语句不再抛出TS2339报错，同时不破坏Detox与Jest运行器的原生适配逻辑，测试流程可正常执行。

内容的提问来源于stack exchange，提问作者Krzysztof Mansz