引言

过去,组件内的代码异常会导致 React 的内部状态被破坏,产生可能无法追踪的错误。但 React 并没有提供一种优雅处理这些错误的方式,也无法从错误中恢复。

默认情况下,若一个组件在渲染期间(render)发生错误,会导致整个组件树全部被卸载,这当然不是我们期望的结果。

部分组件的错误不应该导致整个应用崩溃。为了解决这个问题,React 16 引入了一个新的概念 —— 错误边界

错误边界是一种 React 组件,这种组件可以捕获发生在其子组件树任何位置的异常,并打印这些错误,同时展示降级 UI,而并不会渲染那些发生崩溃的子组件树。

注意

  • 错误边界目前只在 Class Component 中实现了,没有在 hooks 中实现(因为Error Boundaries的实现借助了this.setState可以传递callback的特性,useState无法传入回调,所以无法完全对标);
  • 错误边界 无法捕获 以下四种场景中产生的错误:
    • 事件处理函数(因为 Error Boundaries 实现的本质是触发更新,但是事件处理函数不在render或者commit阶段,所以无法进行捕获,如果你需要在事件处理器内部捕获错误,可以使用原生的 try/catch语句 了解更多)
    • 异步代码(例如setTimeoutrequestAnimationFrame回调函数)
    • 服务端渲染(因为触发更新只能在客户端进行,不能在serve端进行)
    • 它自身抛出来的错误(因为错误抛出要向父节点冒泡寻找 Error Boundaries 处理,无法处理自身产生的错误)

实现

React中提供了两个与错误处理相关的api:

  • getderivedstatefromerror:静态方法,当错误发生后,提供一个机会渲染 Fallback UI
  • componentDidCatch:组件实例方法,当错误发生后,提供一个机会记录错误信息

如果一个 class 组件中定义了getDerivedStateFromError()或componentDidCatch()这两个生命周期方法中的任意一个(或两个)时,那么它就变成一个错误边界。当抛出错误后,请使用getDerivedStateFromError()渲染备用 UI ,使用componentDidCatch()打印错误信息。

class ErrorBoundary extends React.Component {
constructor(props) {
super(props);
this.state = {
hasError: false,
};
}
getDerivedStateFromError(error) {
// 更新 state 使下一次渲染能够显示降级后的 UI
return { hasError: true };
}
componentDidCatch(error, errorInfo) {
// 你同样可以将错误日志上报给服务器
logErrorToService(error, errorInfo);
}
render() {
if (this.state.hasError) {
// 你可以自定义降级后的 UI 并渲染
return <h1>wrong message</h1>;
}
return this.props.children;
}
}
export default ErrorBoundary;

然后你可以将它作为一个常规组件去使用:

<ErrorBoundary>
<A />
<B />
<C />
</ErrorBoundary>

错误边界的工作方式类似于原生的catch {},不同的地方在于,错误边界只针对 React 组件。并且只有 class 组件才可以成为错误边界组件。大多数情况下, 你只需要声明一次错误边界组件, 并在整个应用中使用它。

错误边界应该放置在哪?

错误边界的粒度由你来决定,可以将其包装在最顶层的路由组件中,并为用户展示一个 “xxx” 的错误信息,就像服务端框架经常处理崩溃一样。也可以将单独的组件包装在错误边界,从而保护其它组件不会崩溃。(例如,Facebook Messenger 将侧边栏、信息面板、聊天记录以及信息输入框包装在单独的错误边界中。如果其中的某些 UI 组件崩溃,其余部分仍然能够交互。)

未捕获错误(Uncaught Errors)该如何处理?

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

在某些场景下,把一个错误的 UI 留在那,比完全移除它要更糟糕。比如在类似 Messenger 的产品中,把一个异常的 UI 展示给用户,可能会导致用户把错误信息发给别人。同样,对于支付类场景而言,与其显示错误的支付金额,不如直接让页面白屏。

(所以,错误边界的使用难点在于寻找合适的时机,知道在什么时候该用,什么时候不该用,这是一个充满哲学的问题)

注意:自 React 15 的命名更改

React 15 中有一个支持有限的错误边界方法unstable_handleError。这个方法不再起作用,自 React 16 起你需要在代码中将其修改为componentDidCatch

以上就是React之错误边界 Error Boundaries示例详解的详细内容,更多关于React 错误边界的资料请关注本站其它相关文章!

声明:本站所有文章,如无特殊说明或标注,均为本站原创发布。任何个人或组织,在未征得本站同意时,禁止复制、盗用、采集、发布本站内容到任何网站、书籍等各类媒体平台。如若本站内容侵犯了原著者的合法权益,可联系我们进行处理。