React Native Exception Handler

screenshot of React Native Exception Handler

React Native Exception Handler

A react native module that lets you to register a global error handler that can capture fatal/non fatal uncaught exceptions.


The react-native-exception-handler npm package is a module for React Native that enables developers to register a global error handler to capture both fatal and non-fatal uncaught exceptions. By using this module, developers can prevent their React Native apps from crashing abruptly without providing a graceful error message to users.


  • Global Error Handler: Allows for registering a global error handler to capture exceptions.
  • Prevent App Crashes: Helps in preventing unexpected app crashes by handling errors effectively.
  • Support for Unhandled Native Exceptions: Version 2 of the module supports catching unhandled native exceptions, in addition to JS exceptions.


  1. To install using yarn:

    yarn add react-native-exception-handler
  2. To install using npm:

    npm i react-native-exception-handler --save
  3. For automatic installation, run:

    react-native link react-native-exception-handler
  4. For manual installation on iOS:

    • Add ReactNativeExceptionHandler.xcodeproj to your XCode project.
    • Add libReactNativeExceptionHandler.a to your project's Build Phases.
    • Run your project.
  5. For manual installation on Android:

    • Update android/app/src/main/java/[...]/
    • Add the ReactNativeExceptionHandlerPackage() to the package list.
    • Update android/settings.gradle and android/app/build.gradle with required dependencies.


The react-native-exception-handler npm module is a valuable tool for React Native developers to handle errors and exceptions effectively, preventing apps from crashing abruptly. By providing features like a global error handler, support for unhandled native exceptions, and detailed installation instructions, this module simplifies the process of error handling in React Native applications.


React is a widely used JavaScript library for building user interfaces and single-page applications. It follows a component-based architecture and uses a virtual DOM to efficiently update and render UI components

React Native

React Native is a framework for building mobile applications using React and JavaScript. It enables developers to write once and deploy to multiple platforms, including iOS, Android, and the web, while providing a native app-like experience to users.


ESLint is a linter for JavaScript that analyzes code to detect and report on potential problems and errors, as well as enforce consistent code style and best practices, helping developers to write cleaner, more maintainable code.