用途：Detox 用于 React Native 应用的移动端端到端（E2E）自动化测试，覆盖 iOS 和 Android。与 Appium 的黑盒方式不同，Detox 采用灰盒方式在应用内部运行并监控主线程，能感知应用何时忙碌或空闲，从而消除不稳定的等待。
主要能力：通过 WebSocket 连接测试运行器与应用内的原生 Detox Agent，监控 React Native Bridge、网络请求、动画和定时器，仅在应用完全空闲时执行操作。使用 by.id、by.text 等匹配器与 element、expect 等 API 操作原生元素，支持设备控制与深链接（如 device.openURL）。
使用方式：在测试中通过 device.launchApp() 启动应用，用 element(by.id("hello_button")).tap() 执行点击，用 expect(element(by.text("Hello!!!"))).toBeVisible() 断言可见性。建议为 React Native 组件设置 testID 以便跨平台匹配，测试中禁用无限动画，CI 中使用 release/staging 构建，并用 Mock 服务器保持外部 API 调用确定性。
适用场景：React Native 移动应用的灰盒集成测试、无 flake 的移动测试、移动 CI/CD 中的发布验证，以及本地快速反馈。
限制与注意：不要使用 sleep 超时，应依赖自动空闲同步；不要用 Detox 测试第三方社交登录 WebView，应在 React Native 状态层模拟认证响应；不要忽略 detox 构建产物，失败时可录制视频和截图。常见问题包括应用同步失败（后台循环、动画或定时器阻塞，可禁用无限定时器或使用 device.disableSynchronization()）、找不到模拟器/仿真器（需更新 .detoxrc.js）、元素未找到（需确保 testID 传递到原生组件且可见）。