过去,组件内部的 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 组件树被卸载。