Detox — Gray box end-to-end testing and automation framework for mobile apps

Overview

Detox is a gray box end-to-end testing and automation framework for mobile apps, designed to test apps while they're running in a real device/simulator, interacting with it just like a real user. It's built to tackle flakiness in E2E tests by moving from black box testing to gray box testing, providing a more reliable and deterministic testing experience.

Key Features

Cross Platform: Write end-to-end tests in JavaScript for React Native apps (Android & iOS).
Debuggable: Modern async-await API allows breakpoints in asynchronous tests to work as expected.
Automatically Synchronized: Stops flakiness at the core by monitoring asynchronous operations in your app.
Made For CI: Execute your E2E tests on CI platforms like Travis CI, Circle CI or Jenkins without grief.
Test Runner Agnostic: Detox provides a set of APIs to use with any test runner without it. It comes with Jest integration out of the box.

Use Cases

Mobile app developers: Use Detox to write and run reliable end-to-end tests for their React Native apps, ensuring high-quality user experiences.
QA teams: Utilize Detox to automate testing workflows and reduce reliance on manual QA, improving efficiency and test coverage.
Continuous Integration: Integrate Detox into CI pipelines to automatically run E2E tests on every build, catching regressions and issues early in the development cycle.

Advantages

Reduces flakiness in E2E tests by using gray box testing approach.
Provides a modern, debuggable API for writing asynchronous tests.
Supports both Android and iOS platforms, making it a versatile solution for cross-platform app development.
Integrates well with popular CI tools, enabling automated testing in continuous integration workflows.

Limitations / Considerations

Currently, Detox does not support testing on iOS simulators.
As an E2E testing framework, Detox may not be suitable for unit or component-level testing.

Appium: An open-source test automation framework for mobile applications, supporting both Android and iOS. Unlike Detox, Appium is a black box testing tool.
Espresso: A UI testing framework for Android applications. It's a white box testing tool, unlike Detox's gray box approach.
XCUITest: Apple's UI testing framework for iOS apps. It's a white box testing tool, unlike Detox's gray box approach.

Basic Information

GitHub: https://github.com/wix/Detox
Stars: 11,625
License: MIT
Last Commit: 2025-09-18

📊 Project Information

Project Name: Detox
GitHub URL: https://github.com/wix/Detox
Programming Language: JavaScript
⭐ Stars: 11,625
🍴 Forks: 1,918
📅 Created: 2016-06-15
🔄 Last Updated: 2025-09-18

🏷️ Project Topics

Topics: [, ", a, n, d, r, o, i, d, ", ,, , ", a, u, t, o, m, a, t, i, o, n, ", ,, , ", e, 2, e, -, t, e, s, t, s, ", ,, , ", h, a, c, k, t, o, b, e, r, f, e, s, t, ", ,, , ", h, a, c, k, t, o, b, e, r, f, e, s, t, 2, 0, 2, 4, ", ,, , ", i, o, s, ", ,, , ", j, a, v, a, s, c, r, i, p, t, ", ,, , ", r, e, a, c, t, -, n, a, t, i, v, e, ", ,, , ", t, e, s, t, -, a, u, t, o, m, a, t, i, o, n, ", ,, , ", t, e, s, t, i, n, g, ", ,, , ", t, e, s, t, i, n, g, -, t, o, o, l, s, ", ]