Detox同测试套件内测试间无法重置应用状态的问题

问题背景 #

我将多个Detox测试文件/套件按应用高阶功能拆分，当前Detox配置如下：

detox: {
  behavior: {
    cleanup: {
      shutdownDevice: true,
    },
    init: {
      exposeGlobals: false,
      keepLockFile: false,
      reinstallApp: true,
    },
    launchApp: 'auto',
  },
},

调用device.launchApp时设置了newInstance: true参数。目前不同测试文件间应用状态可正常重置，但同套件内的测试间状态无法彻底清除——比如套件内第一个测试完成登录后，第二个测试启动时应用仍处于登录状态。

已尝试的无效/有问题方案：

• 在afterEach中调用device.terminateApp，无效果；
• 调用device.uninstallApp，触发大量未调试错误；
• 依赖Detox 20文档中newInstance的重置能力，但实际未清除AsyncStorage等存储数据。

可行解决方案 #

1. 启动应用时明确指定清除存储参数 #

newInstance: true仅创建新进程，不会主动清除存储。在beforeEach中调用launchApp时，针对不同平台添加清除参数：

beforeEach(async () => {
  await device.launchApp({
    newInstance: true,
    // iOS 用 delete 清除沙盒数据
    delete: device.getPlatform() === 'ios',
    // Android 用 clear 清除SharedPreferences等存储
    clear: device.getPlatform() === 'android'
  });
});

该方法直接清除应用的所有沙盒/存储数据，确保每次测试从干净状态启动。

2. 应用内暴露测试专用清除接口 #

在应用代码中添加测试环境专用的存储清除方法，通过Detox的invoke调用：

// 应用代码（仅在测试环境编译，可通过babel宏或环境变量控制）
if (process.env.NODE_ENV === 'test') {
  global.clearAppStorage = async () => {
    await AsyncStorage.clear();
    // 若有其他持久化存储（如Redux Persist、Keychain），需在此一并清除
  };
}

// 测试文件的afterEach钩子
afterEach(async () => {
  await device.invoke('clearAppStorage');
  await device.terminateApp();
});

这种方式无需重装应用，测试效率更高，但需要应用代码配合添加测试接口。

3. 强制Detox每次测试重装应用 #

修改Detox配置中reinstallApp的值为'always'，强制每次测试（无论是否同套件）都重新安装应用：

detox: {
  behavior: {
    cleanup: {
      shutdownDevice: true,
    },
    init: {
      exposeGlobals: false,
      keepLockFile: false,
      reinstallApp: 'always', // 改为always，强制每次测试重装
    },
    launchApp: 'auto',
  },
},

注意：该方法会增加测试耗时，适合对测试隔离要求极高的场景。

4. iOS平台专属：重置模拟器内容 #

针对iOS测试，可在启动前重置模拟器的所有内容和设置：

beforeEach(async () => {
  if (device.getPlatform() === 'ios') {
    await device.resetContentAndSettings();
  }
  await device.launchApp({ newInstance: true });
});

该方法会清除模拟器上所有应用的数据，适合跨应用测试或极端隔离需求的场景，同样会增加测试时间。

核心说明 #

• Detox默认同套件内测试可共享状态，因此newInstance: true不会自动清除存储，需手动指定清除策略；
• 不同平台的存储位置不同，需针对性设置清除参数；
• 优先选择前两种方案，在测试效率和隔离性之间取得平衡。

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