This package has been deprecated
All projects should upgrade to our universal JS notifier: "@bugsnag/js" and the accompanying plugins, e.g. "@bugsnag/plugin-react". See https://github.com/bugsnag/bugsnag-js/blob/master/UPGRADING.md for more details.
This package enables you to integrate Bugsnag's error reporting with React's error boundaries. It creates and configures an
<ErrorBoundary/> component which will capture and report unhandled errors in your component tree. You either use the
<ErrorBoundary/> directly, or extend it to provide some fallback UI for your users.
Reported errors will contain useful debugging info from Reacts's internals such as the component name where the error originated, and the component stack.
You can opt to install the package from npm, using the instructions below. Alternatively you can load the plugin from our CDN via a
npm i --save bugsnag-js bugsnag-react# oryarn add bugsnag-js bugsnag-react
Depending on how your application is structured, usage differs slightly:
Inline script tag
The script tag creates a global function called
bugsnag__react which needs to be passed a reference to the
React object. Ensure that
React is defined before calling this function.
See the example for more info.
// initialize bugsnag ASAP, before other importsconst bugsnagClient =// wrap your entire app tree in the ErrorBoundary providedconst ErrorBoundary = bugsnagClientReactDOM
- Check out the documentation
- Search open and closed issues for similar problems
- Report a bug or request a feature
The Bugsnag JS library and official plugins are free software released under the MIT License. See LICENSE.txt for details.