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

全局错误处理

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

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 钩子来捕获子孙组件中的错误:

<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,你可以确保应用的稳定性,即使在面对未预料的错误时也能优雅地处理。这对于生产环境中的错误监控和用户体验至关重要。