Vue3 onErrorCaptured errorHandler 异常处理

AdleyTales2024-03-16 20:08

onErrorCaptured 是 Vue 3 中的一个全局或局部生命周期钩子，用于处理组件在渲染过程中抛出的错误。当组件发生错误并且没有被任何父组件的 errorCaptured 钩子捕获时，这个钩子会被触发。它允许你在全局或局部范围内处理和记录错误，以避免整个应用因为未捕获的错误而崩溃。

全局错误处理

你可以在 Vue 应用实例化时使用 createApp 方法的 config 选项来设置全局错误处理函数：

cpp 复制代码

import { createApp } from 'vue';
import App from './App.vue';

const app = createApp(App);

app.config.errorHandler = (err, instance, source) => {
  console.error('Unhandled error:', err);
  // 可以在这里添加错误报告的逻辑，如发送到服务器
};

app.mount('#app');

局部错误处理

在组件内部，你可以使用 onErrorCaptured 钩子来捕获子孙组件中的错误：

cpp 复制代码

<script setup>
import { onErrorHandler, getCurrentInstance } from 'vue';

const instance = getCurrentInstance();

onErrorHandler((err, instance, source) => {
  console.error('Component caught an error:', err);
  // 可以在这里处理错误，例如记录到日志或显示错误信息
});
</script>

在这个例子中，onErrorHandler 是 onErrorCaptured 的一个别名，它在

错误处理的顺序

当一个错误发生时，Vue 会按照以下顺序进行错误捕获：

组件的 errorCaptured 钩子（如果有的话）。

父组件的 errorCaptured 钩子，向上逐级传递。

如果到达根实例仍未被捕获，Vue 将调用全局 config.errorHandler 钩子（如果有设置的话）。

如果全局 errorHandler 也没有捕获错误，错误将被抛出到全局错误处理机制中。

通过使用 onErrorCaptured，你可以确保应用的稳定性，即使在面对未预料的错误时也能优雅地处理。这对于生产环境中的错误监控和用户体验至关重要。