前言 📝
👉 从 React 16 开始,引入了 Error Boundaries 概念,它可以捕获它的子组件中产生的错误,记录错误日志,并展示降级内容,具体 官网地址。 👈
错误边界避免一个组件错误导致整个页面白屏不能使用等情况,使用优雅降级的方式呈现备用的 UI,错误边界可以在渲染期间、生命周期和整个组件树的构造函数中捕获错误。自 React 16 起,任何未被错误边界捕获的错误将会导致整个 React 组件树被卸载
ErrorBoundary 意义 🤖
- 某些 UI 崩溃,不至于整个 webapp 崩溃
在浏览页面时,由于后端返回异常或者前端的某些错误校验,会导致用户体验很差,你想想,你带着老婆,坐着火车,吃着火锅唱着歌,突然被麻匪劫了,突然就报错了,有些场景下,比如正在设置金额,或者查看关键页面时,这样的体验就会很糟糕,比如你游戏充值了 500,结果由于接口原因显示出来充值NaN
,这种显示比不显示还让人苦恼,不过相信大家对 JS 异常捕获很熟悉了,try-catch
一包业务代码就收工了。不过,在组件里对异常捕获,需要用到的是 React 提供的 Error Boundary
错误边界特性,用 componentDidCatch
钩子来对页面异常进行捕获,以至于不会将异常扩散到整个页面,有效防止页面白屏。
官网如何实现 🥔
👉 如果一个 class 组件中定义了 static getDerivedStateFromError() 或 componentDidCatch() 这两个生命周期方法中的任意一个(或两个)时,那么它就变成一个错误边界。当抛出错误后,请使用 static getDerivedStateFromError() 渲染备用 UI ,使用 componentDidCatch() 打印错误信息 👈
class ErrorBoundary extends React.Component {
constructor(props) {
super(props);
this.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>
错误边界的工作方式类似于 JavaScript 的 catch {}
,不同的地方在于错误边界只针对 React
组件。只有 class
组件才可以成为错误边界组件。大多数情况下, 你只需要声明一次错误边界组件, 并在整个应用中使用它,在使用时被包裹组件出现的错误或者throw new Error()
抛出的异常都可以被错误边界组件捕获,并且显示出兜底 UI
封装一个可配置的 ErrorBoundary 🚲
了解了官网实现错误边界组件的方法,我们可以封装一个ErrorBoundary
组件,造一个好用的轮子,而不是直接写死return <h1>Something went wrong</h1>
,学习了react-redux
原理后我们知道可以用高阶组件来包裹react
组件,将store
中的数据和方法全局注入,同理,我们也可以使用高阶组件包裹使其成为一个能够错误捕获的 react 组件
1️⃣ 创造一个可配置的 ErrorBoundary 类组件
相比与官网的 ErrorBoundary
,我们可以将日志上报的方法以及显示的 UI
通过接受传参的方式进行动态配置,对于传入的UI
,我们可以设置以react
组件的方式 或 是一个React Element
进行接受,而且通过组件的话,我们可以传入参数,这样可以在兜底 UI 中拿到具体的错误信息
- componentDidCatch() : 错误日志处理的钩子函数
- static getDerivedStateFromError() : 它将抛出的错误作为参数,并返回一个值以更新 state