如何在React Native的Detox测试中设置AsyncStorage默认值

你不需要全局mock AsyncStorage，有两种适配Detox测试场景的方案可选，都可以仅针对你需要的特定key设置值，不会影响其他存储项的正常读写：

方案1：使用Detox的启动参数传递初始值（推荐，无需修改业务逻辑） #

Detox支持在应用启动时传入自定义参数，你只需要在业务代码的启动阶段增加一行兼容逻辑，优先读取启动参数的对应值写入AsyncStorage即可：

• 第一步：在应用初始化逻辑（如App.tsx的启动钩子）中增加兼容逻辑

import AsyncStorage from '@react-native-async-storage/async-storage';
import { NativeModules } from 'react-native';

// 应用启动时优先执行
const initAsyncStorageDefaults = async () => {
  // 读取Detox传入的启动参数
  const launchArgs = NativeModules.DeviceInfo?.launchArguments || {};
  if (launchArgs.SKIP_WELCOME_MODAL) {
    // 仅当启动参数存在对应值时，写入指定的AsyncStorage键
    await AsyncStorage.setItem('has_seen_welcome_modal', launchArgs.SKIP_WELCOME_MODAL);
  }
}

• 第二步：在Detox测试用例的beforeEach阶段传入对应启动参数

beforeEach(async () => {
  await device.launchApp({
    launchArgs: {
      SKIP_WELCOME_MODAL: 'true'
    },
    newInstance: true // 每次启动全新应用实例，避免本地缓存影响测试结果
  });
});

这个方案的优势是完全不需要mock任何方法，和生产环境的存储逻辑完全一致，测试结果可信度更高。

方案2：部分mock AsyncStorage的getItem方法（仅针对特定key） #

如果你不想修改业务代码，可以用jest做局部mock，不需要全局改写所有getItem逻辑：

// 在当前测试文件顶部引入AsyncStorage
import AsyncStorage from '@react-native-async-storage/async-storage';

// 仅mock指定key的返回值，其余key走原生存储逻辑
jest.mock('@react-native-async-storage/async-storage', () => {
  const originalModule = jest.requireActual('@react-native-async-storage/async-storage');
  return {
    ...originalModule,
    getItem: jest.fn((key) => {
      if (key === 'has_seen_welcome_modal') {
        return Promise.resolve('true');
      }
      // 其他key调用原生方法返回真实值
      return originalModule.getItem(key);
    })
  };
});

注意这个方案仅适用于JS层的组件测试，如果你运行的是Detox端到端黑盒测试，这个mock不会生效——因为Detox测试运行在独立进程，和应用的JS运行环境隔离，该场景下优先选择方案1。

注意事项 #

• 如果你的AsyncStorage做了加密封装，方案1依然适用，只需要把启动参数传入的值按照你的加密规则处理后再写入即可。
• 测试结束后如果需要清理存储残留，可以在afterEach阶段调用await device.clearKeychain()（iOS）或者await device.uninstallApp()（安卓），避免影响其他测试用例。

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