react-native-crash-tester

react-native-crash-tester

Deliberately crash your app. Good for testing crash reporting services.

Installation

npm install react-native-crash-tester

or

yarn add react-native-crash-tester

Usage

Trigger a Native Crash

import CrashTester from 'react-native-crash-tester';

CrashTester.nativeCrash();
CrashTester.nativeCrash('Custom message!');

Trigger a JavaScript Crash

import CrashTester from 'react-native-crash-tester';

CrashTester.jsCrash();
CrashTester.jsCrash('Custom message!');

Test a React Error Boundary

import * as React from 'react';
import { Button } from 'react-native';
import { CrashingComponent } from 'react-native-crash-tester';
import ErrorBoundary from './MyErrorBoundary';

function TestComponent() {
  const [shown, setShown] = React.useState(false);

  <ErrorBoundary>
    <Button title="Crash" onPress={() => setShown(true)} />
    {shown && <CrashingComponent />}
  </ErrorBoundary>;
}

You can run the app in ./example to see sample usage.

Contributing

See the contributing guide to learn how to contribute to the repository and the development workflow.

License

MIT

Changelog

0.2.1 (2021-06-02)

Features

• add component for testing component tree crashes (c102006)
• add js crash method (47199ac)
• add native crash method to android (581e01d)
• iOS native crash support (ffc04a6)
• support for exception message in java (1acd901)
• update example app with test cases (fe2d931)