React 16 中的異常處理

React 16 中的異常處理翻譯自 React 官方文檔，從屬於筆者的 React 與前端工程化實踐系列中的 React 組件分割與解耦章節；也可使用 create-webpack-app 運行本部分示例 。

異常處理

在 React 15.x 及以前的版本中，組件內的異常有可能會影響到 React 的內部狀態，進而致使下一輪渲染時出現未知錯誤。這些組件內的異常每每也是由應用代碼自己拋出，在以前版本的 React 更多的是交託給了開發者處理，而沒有提供較好地組件內優雅處理這些異常的方式。在 React 16.x 版本中，引入了所謂 Error Boundary 的概念，從而保證了發生在 UI 層的錯誤不會連鎖致使整個應用程序崩潰；未被任何異常邊界捕獲的異常可能會致使整個 React 組件樹被卸載。所謂的異常邊界即指某個可以捕獲它的子元素（包括嵌套子元素等）拋出的異常，而且根據用戶配置進行優雅降級地顯示而不是致使整個組件樹崩潰。異常邊界可以捕獲渲染函數、生命週期回調以及整個組件樹的構造函數中拋出的異常。
咱們能夠經過爲某個組件添加新的 componentDidCatch(error, info) 生命週期回調來使其變爲異常邊界：

class ErrorBoundary extends React.Component {
  constructor(props) {
    super(props);
    this.state = { hasError: false };
  }

  componentDidCatch(error, info) {
    // Display fallback UI
    this.setState({ hasError: true });
    // You can also log the error to an error reporting service
    logErrorToMyService(error, info);
  }

  render() {
    if (this.state.hasError) {
      // You can render any custom fallback UI
      return <h1>Something went wrong.</h1>;
    }
    return this.props.children;
  }
}

而後咱們就能夠如常使用該組件：

<ErrorBoundary>
  <MyWidget />
</ErrorBoundary>

componentDidCatch() 方法就好像針對組件的 catch {} 代碼塊；不過 JavaScript 中的 try/catch 模式更多的是面向命令式代碼，而 React 組件自己是聲明式模式，所以更適合採用指定渲染對象的模式。須要注意的是僅有類組件能夠成爲異常邊界，在真實的應與開發中咱們每每會聲明單個異常邊界而後在全部可能拋出異常的組件中使用它。另外值得一提的是異常邊界並不能捕獲其自己的異常，若是異常邊界組件自己拋出了異常，那麼會冒泡傳遞到上一層最近的異常邊界中。
在真實地應用開發中有的開發者也會將崩壞的界面直接展現給開發者，不過譬如在某個聊天界面中，若是在出現異常的狀況下仍然直接將界面展現給用戶，就有可能致使用戶將信息發送給錯誤的接受者；或者在某些支付應用中致使用戶金額顯示錯誤。所以若是咱們將應用升級到 React 16.x，咱們須要將本來應用中沒有被處理地異常統一包裹進異常邊界中。譬如某個應用中可能會分爲側邊欄、信息面板、會話界面、信息輸入等幾個不一樣的模塊，咱們能夠將這些模塊包裹進不一樣的錯誤邊界中；這樣若是某個組件發生崩潰，會被其直屬的異常邊界捕獲，從而保證剩餘的部分依然處於可用狀態。一樣的咱們也能夠在異常邊界中添加錯誤反饋等服務接口以及時反饋生產環境下的異常而且修復他們。完整的應用代碼以下所示：

class ErrorBoundary extends React.Component {
  constructor(props) {
    super(props);
    this.state = { error: null, errorInfo: null };
  }
  
  componentDidCatch(error, errorInfo) {
    // Catch errors in any components below and re-render with error message
    this.setState({
      error: error,
      errorInfo: errorInfo
    })
    // You can also log error messages to an error reporting service here
  }
  
  render() {
    if (this.state.errorInfo) {
      // Error path
      return (
        <div>
          <h2>Something went wrong.</h2>
          <details style={{ whiteSpace: 'pre-wrap' }}>
            {this.state.error && this.state.error.toString()}
            <br />
            {this.state.errorInfo.componentStack}
          </details>
        </div>
      );
    }
    // Normally, just render children
    return this.props.children;
  }  
}

class BuggyCounter extends React.Component {
  constructor(props) {
    super(props);
    this.state = { counter: 0 };
    this.handleClick = this.handleClick.bind(this);
  }
  
  handleClick() {
    this.setState(({counter}) => ({
      counter: counter + 1
    }));
  }
  
  render() {
    if (this.state.counter === 5) {
      // Simulate a JS error
      throw new Error('I crashed!');
    }
    return <h1 onClick={this.handleClick}>{this.state.counter}</h1>;
  }
}

function App() {
  return (
    <div>
      <p>
        <b>
          This is an example of error boundaries in React 16.
          <br /><br />
          Click on the numbers to increase the counters.
          <br />
          The counter is programmed to throw when it reaches 5. This simulates a JavaScript error in a component.
        </b>
      </p>
      <hr />
      <ErrorBoundary>
        <p>These two counters are inside the same error boundary. If one crashes, the error boundary will replace both of them.</p>
        <BuggyCounter />
        <BuggyCounter />
      </ErrorBoundary>
      <hr />
      <p>These two counters are each inside of their own error boundary. So if one crashes, the other is not affected.</p>
      <ErrorBoundary><BuggyCounter /></ErrorBoundary>
      <ErrorBoundary><BuggyCounter /></ErrorBoundary>
    </div>
  );
}



ReactDOM.render(
  <App />,
  document.getElementById('root')
);