Get Started

Error Handling

This guide details a few strategies available for reporting and recovering from errors in your project.

Handling Fatal JS Errors

If your app encounters a fatal JS error, Expo will report the error differently depending on whether your app is in development or production.
In Development: If you're serving your app from Expo CLI, the fatal JS error will be reported to the React Native RedBox and no other action will be taken.
In Production: If your published app encounters a fatal JS error, Expo will immediately reload your app. If the error happens very quickly after reloading, your app will crash.
Expo can also report custom information back to you after your app reloads. If you use ErrorRecovery.setRecoveryProps, and the app later encounters a fatal JS error, the contents of that method call will be passed back into your app's initial props upon reloading. See ErrorRecovery.

We recommend using Sentry to track JS errors in production and configuring our post-publish hook to keep your source maps up to date.

Since Expo's native code never changes with regard to your project, the native symbols aren't especially meaningful (they would show you a trace into the React Native core or into Expo's native SDK). In the vast majority of circumstances *, the JS error is what you care about.
If you need native crash reporting, then we recommend using the Bare workflow, which will allow you to install and use any native library in your project.
* There are a few circumstances where it's possible to crash native code by writing bad JS. Usually these are in areas where it would be performance-prohibitive to add native validation to your code, e.g. the part of the React Native bridge that converts JS objects into typed native values. If you encounter an inexplicable native crash, double check that your parameters are of the right type.