Skip to content

过去,组件内部的 JavaScript 错误会导致 React 的内部状态被破坏,并在下一次渲染时产生无法追踪的错误。React 并没有提供一种在组件中优雅处理的方式,也无法从错误中恢复。

错误边界

错误边界是一种 React 组件,这种组件可以捕获并打印发生在其子组件任何位置的 JavaScript 错误,并且它会渲染出备用的 UI。如果一个 class 组件中定义了 static getDerivedStateFromError() 或 componentDidCatch() 这两个生命周期方法中的任意一个(或两个)时,那么它就变成一个错误边界。当抛出错误后,请使用 static getDerivedStateFromError() 渲染备用 UI ,使用 componentDidCatch() 打印错误信息。 但以下错误无法被捕获:

  • 事件处理
  • 异步代码(例如:setTimeout 或 requestAnimationFrame)
  • 服务端渲染
  • 它自身抛出来的错误(并非它的子组件)
jsx
// 定义错误边界
class ErrorBoundary extends React.Component {
  state = { hasError: false };

  static getDerivedStateFromError(error) {
    // 更新 state 使下一次渲染能够显示降级后的 UI
    return { hasError: true };
  }

  componentDidCatch(error, errorInfo) {
    // 你同样可以将错误日志上报给服务器
    logErrorToMyService(error, errorInfo);
  }

  render() {
    if (this.state.hasError) {
      // 你可以自定义降级后的 UI 并渲染
      return <h1>Something went wrong.</h1>;
    }

    return this.props.children;
  }
}

// 使用
<ErrorBoundary>
  <MyWidget />
</ErrorBoundary>;

错误边界放置在哪?

错误边界的使用由具体的场景来决定,可以将它放置在最顶层的路由组件并为用户展示一个错误,也可以单独将特定组件包装在错误边界中。

未捕获的错误

自 React16 以来,任何未被错误边界捕获的错误将会导致整个 React 组件树被卸载。