Skip to content
A framework using React Boundary handles error easily
JavaScript TypeScript CSS HTML
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.


npm Build Status codecov

English | 简体中文

Why we create catch-react-error


This project make it easy to protect your react source code。

We combine decorators and React Error Boundaries together.

The React Error Boundaries don't support the Server Side Rendering,so we use try/catch to deal such condition.

The catch-react-error takes only one argument,React Error Boundary Component. We provide DefaultErrorBoundary as the default argument.

const catchreacterror = (Boundary = DefaultErrorBoundary) => {};


we provide some demo, so you can understand the library more clearly

client side render

cd example-client
npm install
npm run dev

server side render

cd example-server
npm install
npm run dev

How to use

1.install catch-react-error

npm install catch-react-error --save

2. Install ES7 Decorator babel plugin

npm install --save-dev @ babel / plugin-proposal-decorators
npm install --save-dev @ babel / plugin-proposal-class-properties

babel plugin configuration

  "plugins": [
    ["@ babel / plugin-proposal-decorators", { "legacy": true }],
    ["@ babel / plugin-proposal-class-properties", { "loose": true }]

3. import catch-react-error

import catchreacterror from "catch-react-error";

4. Use @catchreacterror on class component

class Count extends React.Component {
  render() {
    const { count } = this.props;
    if (count === 3) {
      throw new Error("count is three");
    return <h1>{count}</h1>;

5. Use @catchreacterror on functionc component

function Count({ count }) {
  if (count === 3) {
    throw new Error("count is three");
  return <h1>{count}</h1>;

const SaleCount = catchreacterror()(Count);

function App() {
  return (
    <div className="App">
      <SaleCount count={3} />
      <button>I'm OK, click me !</button>

6. How to write a CustomErrorBoundary

  1. create an normal Error Boundary Component
class CustomErrorBoundary extends React.Component {
  constructor (props) {
    super (props);
    this.state = {hasError: false};

  static getDerivedStateFromError (error) {
    return {hasError: true};

  componentDidCatch (error, errorInfo) {
      //do something as needed
    logErrorToMyService (error, errorInfo);

  render () {
    if (this.state.hasError) {
      return <h1> Something with my app,fallback ui. </ h1>;

    return this.props.children;
  1. pass it as the argument
class Count extends React.Component {}


const SaleCount = catchreacterror(CustomErrorBoundary)(Count);



You can’t perform that action at this time.