如何向Detox传递自定义launchArgs启动参数并正确获取参数值

安全阿岳

2026-9-23

核心问题说明

问题1：launchArgs不支持直接传递嵌套对象

Detox的launchArgs本质是透传给移动端操作系统的启动参数，iOS启动参数、Android Intent Extra本身都只支持扁平的基础类型（字符串、数字等）键值对，不接受嵌套对象结构。你直接传入嵌套的users对象时，Detox不会自动做序列化处理，参数会在传递过程中丢失。

问题2：对`device.appLaunchArgs.get()`的用途存在误解

这个API的作用是获取你通过device.appLaunchArgs相关方法预先配置、尚未触发应用启动的待传递参数，不是用来读取已经通过device.launchApp()传入的参数，所以你在启动应用后调用该方法只能拿到空对象。

正确实现方案

传递参数前先把复杂嵌套对象序列化为JSON字符串，放到launchArgs的扁平键中：

beforeAll(async () => {
    await device.launchApp({
        newInstance: true, 
        permissions: {notifications: 'YES'},
        launchArgs: {
            // 嵌套对象转JSON字符串后传递
            users: JSON.stringify({
                user1: { email: '123@abc.com', pass: '123456' },
                user2: { email: 'abc@123.com', pass: '654321' },
            })
        }
    });
});

如果你需要在测试侧读取配置的启动参数，可以先通过appLaunchArgsAPI预先配置再启动应用：

// 预先配置启动参数
await device.appLaunchArgs.modify({
    users: JSON.stringify({
        user1: { email: '123@abc.com', pass: '123456' },
        user2: { email: 'abc@123.com', pass: '654321' },
    })
});
// 此时调用get可正常拿到配置的参数
console.log(await device.appLaunchArgs.get());
// 再执行启动应用操作
await device.launchApp({
    newInstance: true, 
    permissions: {notifications: 'YES'}
});