react-native-firebase/docs/crashlytics/quick-start.md

title, description

title	description
Quick Start	Getting started with Crashlytics in React Native Firebase

Crashlytics Quick Start

Installation

Install this module with Yarn:

yarn add @react-native-firebase/crashlytics

Integrating manually and not via React Native auto-linking? Check the setup instructions for Android & iOS.

Module usage

The Crashlytics package will automatically report on any fatal application crash. Both native and JavaScript crashes along with unhandled promise rejections are captured with full stack traces.

The package provides a JavaScript API to create your own crash reports and/or send additional information with crash reports to the Firebase console for a better debugging experience.

Once installed, import the Crashlytics package into your project:

import crashlytics from '@react-native-firebase/crashlytics';

The package also provides access to the firebase instance:

import { firebase } from '@react-native-firebase/crashlytics';

Testing crashes

The Crashlytics package provides a crash method which is provided to ensure crash reports are correctly being sent to the Firebase console and can be used with your own test suite. Any log methods called before sending a crash report and sent with the crash report.

import crashlytics from '@react-native-firebase/crashlytics';

function forceCrash() {
  crashlytics.log('Testing crash');
  crashlytics.crash();
}

Handling non-fatal crashes

Crashlytics supports sending JavaScript stack traces to the Firebase console. This can be used in any situations where an error occurs but is caught by your own code as a bailout method. To send a stack trace, pass a JavaScript Error to the recordError method.

import crashlytics from '@react-native-firebase/crashlytics';

function sendReport() {
  crashlytics().recordError(new Error('Error with a stack trace'));
}

Additional crash attributes

It is possible to provide additional attributes which are sent with crash reports. This helps with debugging and localising the error. To set additional attributes call the set* methods.

import crashlytics from '@react-native-firebase/crashlytics';

async function onSignIn(user) {
  await Promise.all([
    crashlytics().setUserId(user.uid),
    crashlytics().setUserName(user.username),
    crashlytics().setUserEmail(user.email),
    crashlytics().setAttribute('credits', user.credits),
  ]);

  crashlytics.crash();
}

Disabling Crashlytics

To disable Crashlytics, set the <VALUE> to false in the firebase.json file.

To learn more, view the App documentation.