errorCaptured 捕获后代错误

最后更新：2026-10-22

errorCaptured 捕获后代组件的错误：返回 false 可阻止继续向上冒泡到全局处理器。

📝 语法

export default {
  errorCaptured(err, vm, info) {
    return false   // 阻止继续冒泡
  }
}

value	err 错误对象、vm 出错实例、info 来源描述

返回值：返回 false 阻止错误继续向上传播

修改下面的代码，在预览区实时查看效果：

输出：

页面显示「已捕获：子组件初始化失败」，整体不白屏。

💡 提示 在顶层组件捕获并上报监控平台是常见做法。

⚠️ 注意 只捕获同步错误：Promise 拒绝与异步回调里的异常要自行处理。

ℹ️ 说明 同一错误会沿组件树向上传播，最近的上层捕获点先拿到。

更多案例即将上线。

Q 能捕获异步错误吗？

A 不能，只捕获渲染/生命周期/侦听器中的同步异常。

Q 和全局 errorHandler 关系？

A return false 就地截断；否则继续交给全局处理器。

Q 怎么设计错误边界 UI？

A 捕获后设置状态并通过 v-if 切换到兜底视图。

Web-Tutorial 技术团队

由多位开发者共同维护的编程教程平台。每篇教程由对应领域的开发者编写和审核，确保内容准确可靠。如发现任何问题，欢迎向我们反馈。