【React篇】组件错误边界处理(组件错误引起的页面白屏)

我们知道在生产环境react错误会导致整个页面崩溃,显示为空白页面。

比如下图的错误,导致了左侧页面直接白屏:

由于某一个组件报错导致整个页面崩溃是很严重的问题,那么我们应该如何去降低代码报错带来的影响呢?

我们希望当页面的某一个组件发生报错时,不要影响到其他组件的显示,比如像下图所示的这种模式 。

通过上图可以看到,某一个组件报错了,但是页面的其他内容还是可以正常显示出来的,并没有受到影响。而实现这种效果就需要使用到异常边界了。

什么是异常边界?

异常边界是React 16以后推出的新特性,使用异常组件可以捕获子组件js的错误,并可以展示备用UI的class组件。

异常边界如何实现

下面代码实现了一个简单的异常边界组件,需要注意的是,异常边界组件必须使用class组件,不能使用函数式组件。

下面咱们举个例子封装一个异常边界组件:

javascript 复制代码
class ErrorWrapper extends React.Component {
  constructor(props) {
    super(props);
    this.state = {
      hasError: false,
    };
  }

  static getDerivedStateFromError(error) {
    return {
      hasError: true,
    };
  }

  componentDidCatch(error, errorInfo) {
    // 一些错误上报的操作
    // ......
  }

  render() {
    if (this.state.hasError) {
      return (
        <Result
          status="error"
          title="哇哦,出现了错误"
          subTitle="请联系管理员"
        ></Result>
      );
    }
    return this.props.children;
  }
}

export default ErrorWrapper;
怎么使用异常组件

只需要将组件作为ErrorWrapper的子组件来使用就可以了,如下代码:

javascript 复制代码
// 定义一个需要渲染的组件
const Child = () => {
  return <div>子组件</div>
}
const Child2 = () => {
  return <div>子组件2</div>
}


// 在父页面使用异常边界组件包裹该子组件
const Parent = () => {
  return <>
    <ErrorWrapper><Child /></ErrorWrapper>
    <ErrorWrapper><Child2 /></ErrorWrapper>
  </>
} 

有哪些限制

虽然异常捕获可以捕获子组件的错误,但是它还是存在一些限制,比如:

  1. 事件里面的报错
  2. 捕获不了异步代码(比如setTimeout,Promise)中的异常
  3. 捕获不了服务端渲染的错误
  4. 假如异常边界组件ErrorWrapper自身报错了,也不能被捕获

请大家根据自身业务需求选择性使用。

相关推荐
崔庆才丨静觅7 小时前
hCaptcha 验证码图像识别 API 对接教程
前端
passerby60618 小时前
完成前端时间处理的另一块版图
前端·github·web components
掘了8 小时前
「2025 年终总结」在所有失去的人中,我最怀念我自己
前端·后端·年终总结
崔庆才丨静觅8 小时前
实用免费的 Short URL 短链接 API 对接说明
前端
崔庆才丨静觅9 小时前
5分钟快速搭建 AI 平台并用它赚钱!
前端
崔庆才丨静觅9 小时前
比官方便宜一半以上!Midjourney API 申请及使用
前端
Moment9 小时前
富文本编辑器在 AI 时代为什么这么受欢迎
前端·javascript·后端
崔庆才丨静觅9 小时前
刷屏全网的“nano-banana”API接入指南!0.1元/张量产高清创意图,开发者必藏
前端
剪刀石头布啊10 小时前
jwt介绍
前端
爱敲代码的小鱼10 小时前
AJAX(异步交互的技术来实现从服务端中获取数据):
前端·javascript·ajax