Skip to main content
Version: Next

Investigating Failures

There are a few tricks and tools that can help you to understand the reason for test failures, even before you resort to debugging.

Using Detox test artifacts​

Artifacts are very powerful tool to understand your test failure, you can easily make a screenshot, video or even hierarchy of your app under test, e.g.:

detox test -c <configuration> --take-screenshots failing --record-videos failing

Learn more about configuration of Detox test artifacts and available CLI options.

Switch to verbose log levels​

You can get detailed information about the test execution if you use debug or trace log level:

detox test -c <configuration> -l trace

In most cases we recommend using debug log level to understand the failed test better.

Missing elements​

If your tests are failing due to non-existent or invisible elements, you can inspect the native view hierarchy to understand better the failure reason.

More recipes​

See Dealing With Problems With Running Tests guide for more recipes.


If debugging still seems a viable option, please follow our debugging guide.