docs: add <ErrorBoundary> docs

Author: streamich

README.md

@@ -80,7 +80,7 @@ const MyComponent = mock();
      - [`<FullScreen>`](./docs/en/FullScreen.md)
   - [Boundaries](./docs/en/Boundaries.md)
      - [`<BrowserOnly>`](./docs/en/BrowserOnly.md), [`<ServerOnly>`](./docs/en/ServerOnly.md), and [`<ElectronOnly>`](./docs/en/ElectronOnly.md)
-     - `<ErrorBoundary>` and `withErrorBoundary()`
+     - [`<ErrorBoundary>`](./docs/en/ErrorBoundary.md) and `withErrorBoundary()`
      - `<CacheBoundary>`
   - [UI](./docs/en/UI.md)
      - [`<Slider>`](./docs/en/Slider.md)

docs/en/Boundaries.md

@@ -6,3 +6,4 @@ according to some semantic meaning.
 - [`<BrowserOnly>`](./BrowserOnly.md) &mdash; renders children only in browser.
 - [`<ServerOnly>`](./ServerOnly.md) &mdash; renders children only on server.
 - [`<ElectronOnly>`](./ElectronOnly.md) &mdash; renders children only in an Electron app.
+- [`<ErrorBoundary>`](./ErrorBoundary.md) &mdash; reports errors in its children.

docs/en/ErrorBoundary.md

@@ -0,0 +1,39 @@
+# `<ErrorBoundary>`
+
+Creates an error boundary, using [React's `.componentDidCatch()` API](https://reactjs.org/blog/2017/07/26/error-handling-in-react-16.html).
+
+## Usage
+
+```jsx
+import {ErrorBoundary} from 'libreact/lib/ErrorBoundary';
+
+<ErrorBoundary
+  renderError={({error, info}) => <div>ERROR!</div>}
+  onError={({error, info}) => {/* ... */}}
+>
+  <div>
+    This code is protected by error boundary.
+  </div>
+</ErrorBoundary>
+```
+
+## Props
+
+Signature
+
+```ts
+interface IErrorBoundaryProps {
+  renderError?: (state: IErrorBoundaryState) => React.ReactElement;
+  onError?: (error?: Error, info?) => void;
+}
+
+interface IErrorBoundaryState {
+  error?: Error;
+  info?: any;
+}
+```
+
+, were
+
+  - `renderError` &mdash; renderer called if error happened in error boundary's children.
+  - `onError` &mdash; event called every time error detected.

docs/en/README.md

@@ -49,7 +49,7 @@
      - [`<FullScreen>`](./FullScreen.md)
   - [Boundaries](./Boundaries.md)
      - [`<BrowserOnly>`](./BrowserOnly.md), [`<ServerOnly>`](./ServerOnly.md), and [`<ElectronOnly>`](./ElectronOnly.md)
-     - `<ErrorBoundary>` and `withErrorBoundary()`
+     - [`<ErrorBoundary>`](./ErrorBoundary.md) and `withErrorBoundary()`
      - `<CacheBoundary>`
   - [UI](./UI.md)
      - [`<Slider>`](./Slider.md)

src/ErrorBoundary/index.ts

@@ -4,10 +4,7 @@ import {noop} from '../util';
 
 export interface IErrorBoundaryProps {
   children: any;
-  render: any;
-  comp: any;
-  component: any;
-  fallback?: (state: IErrorBoundaryState) => React.ReactElement<any>;
+  renderError?: (state: IErrorBoundaryState) => React.ReactElement<any>;
   onError?: (error?: Error, info?) => void;
 }
 
@@ -30,10 +27,10 @@ export class ErrorBoundary extends Component<any, any> {
 
   render () {
     const {props, state} = this;
-    const {fallback} = props;
+    const {renderError, children} = props;
 
     return state.error ?
-      (typeof fallback === 'function' ? fallback(state) : null) :
-      renderProp(props, state);
+      (typeof renderError === 'function' ? renderError(state) : null) :
+      children;
   }
 }