Vue——vue2错误处理收集【七】

2024-08-15 10:40:21 浏览数 (2)

前言

initEvents中发现的有意思的东西,就是 Vue 针对 Error 的处理,说实话之前压根没在意过 Vue 是如何收集处理 Error 的;

errorHandler:https://v2.cn.vuejs.org/v2/api#errorHandler

?> 从 2.2.0 起,这个钩子也会捕获组件生命周期钩子里的错误。同样的,当这个钩子是 undefined 时,被捕获的错误会通过 console.error 输出而避免应用崩溃。

?> 从 2.4.0 起,这个钩子也会捕获 Vue 自定义事件处理函数内部的错误了。

?> 从 2.6.0 起,这个钩子也会捕获 v-on DOM 监听器内部抛出的错误。另外,如果任何被覆盖的钩子或处理函数返回一个 Promise 链 (例如 async 函数),则来自其 Promise 链的错误也会被处理。

内容

error.ts 位于 src/core/util/error.ts

?> 整体的函数调用流程如下图,当然这只是一般情况下的流程,也存在handleError为入口的情况; 具体的内部细节逻辑就直接来看代码吧。

invokeWithErrorHandling

代码语言:javascript复制
export function invokeWithErrorHandling(
  handler: Function,
  context: any,
  args: null | any[],
  vm: any,
  info: string
) {
  let res
  // 通过try catch进行错误的捕获,如果捕获到错误就调用handleError函数
  try {
    // https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Function/call
    // call() 方法接受的是一个参数列表,而 apply() 方法接受的是一个包含多个参数的数组
    // 如果存在args则通过apply进行处理或者通过call进行处理
    res = args ? handler.apply(context, args) : handler.call(context)
    // 如果存在res & res不是vue实例 & res是个promise函数 & res._handled不为true
    if (res && !res._isVue && isPromise(res) && !(res as any)._handled) {
      res.catch(e => handleError(e, vm, info   ` (Promise/async)`))
      // issue #9511
      // avoid catch triggering multiple times when nested calls
      // 将_handled设置为true避免在嵌套函数中多次触发catch
      ;(res as any)._handled = true
    }
  } catch (e: any) {
    handleError(e, vm, info)
  }
  return res
}

handleError

代码语言:javascript复制
export function handleError(err: Error, vm: any, info: string) {
  // Deactivate deps tracking while processing error handler to avoid possible infinite rendering.
  // See: https://github.com/vuejs/vuex/issues/1505
  // 处理错误的时候停止deps跟踪防止无限渲染
  pushTarget()
  try {
    if (vm) {
      let cur = vm
      // 循环查找$parent直到查找到vue根实例上,因为根实例上不存在$parent也就是undefined
      while ((cur = cur.$parent)) {
        // 获取钩子errorCaptured
        const hooks = cur.$options.errorCaptured
        if (hooks) {
          for (let i = 0; i < hooks.length; i  ) {
            try {
              // 如果errorCaptured返回的为false直接return
              const capture = hooks[i].call(cur, err, vm, info) === false
              if (capture) return
            } catch (e: any) {
              // https://v2.cn.vuejs.org/v2/api/#errorCaptured
              // 执行errorCaptured发生错误时调用globalHandleError
              // 在捕获一个来自后代组件的错误时被调用。
              // 此钩子会收到三个参数:错误对象、发生错误的组件实例以及一个包含错误来源信息的字符串。
              globalHandleError(e, cur, 'errorCaptured hook')
            }
          }
        }
      }
    }
    // 全局的捕获
    globalHandleError(err, vm, info)
  } finally {
    popTarget()
  }
}

globalHandleError

代码语言:javascript复制
function globalHandleError(err, vm, info) {
  // https://v2.cn.vuejs.org/v2/api/#errorHandler
  // 如果全局配置存在.errorHandler则调用errorHandler输出错误信息
  // 没配置的话在浏览器环境下会通过console.error打印错误
  if (config.errorHandler) {
    try {
      return config.errorHandler.call(null, err, vm, info)
    } catch (e: any) {
      // if the user intentionally throws the original error in the handler,
      // do not log it twice
      // 如果通过errorHandler处理发生了错误,就直接抛出防止错误被二次打印
      if (e !== err) {
        logError(e, null, 'config.errorHandler')
      }
    }
  }
  logError(err, vm, info)
}

logError

代码语言:javascript复制
// 输出错误信息
function logError(err, vm, info) {
  // DEV环境下直接发出警告
  if (__DEV__) {
    warn(`Error in ${info}: "${err.toString()}"`, vm)
  }
  // 如果是浏览器环境下且console不为undefined
  // 就直接console.error输出错误信息
  // 否则就抛出
  /* istanbul ignore else */
  if (inBrowser && typeof console !== 'undefined') {
    console.error(err)
  } else {
    throw err
  }
}

完整源码

代码语言:javascript复制
import config from '../config'
import { warn } from './debug'
import { inBrowser } from './env'
import { isPromise } from 'shared/util'
import { pushTarget, popTarget } from '../observer/dep'

export function handleError(err: Error, vm: any, info: string) {
  // Deactivate deps tracking while processing error handler to avoid possible infinite rendering.
  // See: https://github.com/vuejs/vuex/issues/1505
  // 处理错误的时候停止deps跟踪防止无限渲染
  pushTarget()
  try {
    if (vm) {
      let cur = vm
      // 循环查找$parent直到查找到vue根实例上,因为根实例上不存在$parent也就是undefined
      while ((cur = cur.$parent)) {
        // 获取钩子errorCaptured
        const hooks = cur.$options.errorCaptured
        if (hooks) {
          for (let i = 0; i < hooks.length; i  ) {
            try {
              // 如果errorCaptured返回的为false直接return
              const capture = hooks[i].call(cur, err, vm, info) === false
              if (capture) return
            } catch (e: any) {
              // https://v2.cn.vuejs.org/v2/api/#errorCaptured
              // 执行errorCaptured发生错误时调用globalHandleError
              // 在捕获一个来自后代组件的错误时被调用。
              // 此钩子会收到三个参数:错误对象、发生错误的组件实例以及一个包含错误来源信息的字符串。
              globalHandleError(e, cur, 'errorCaptured hook')
            }
          }
        }
      }
    }
    // 全局的捕获
    globalHandleError(err, vm, info)
  } finally {
    popTarget()
  }
}

export function invokeWithErrorHandling(
  handler: Function,
  context: any,
  args: null | any[],
  vm: any,
  info: string
) {
  let res
  // 通过try catch进行错误的捕获,如果捕获到错误就调用handleError函数
  try {
    // https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Function/call
    // call() 方法接受的是一个参数列表,而 apply() 方法接受的是一个包含多个参数的数组
    // 如果存在args则通过apply进行处理或者通过call进行处理
    res = args ? handler.apply(context, args) : handler.call(context)
    // 如果存在res & res不是vue实例 & res是个promise函数 & res._handled不为true
    if (res && !res._isVue && isPromise(res) && !(res as any)._handled) {
      res.catch(e => handleError(e, vm, info   ` (Promise/async)`))
      // issue #9511
      // avoid catch triggering multiple times when nested calls
      // 将_handled设置为true避免在嵌套函数中多次触发catch
      ;(res as any)._handled = true
    }
  } catch (e: any) {
    handleError(e, vm, info)
  }
  return res
}

function globalHandleError(err, vm, info) {
  // https://v2.cn.vuejs.org/v2/api/#errorHandler
  // 如果全局配置存在.errorHandler则调用errorHandler输出错误信息
  // 没配置的话在浏览器环境下会通过console.error打印错误
  if (config.errorHandler) {
    try {
      return config.errorHandler.call(null, err, vm, info)
    } catch (e: any) {
      // if the user intentionally throws the original error in the handler,
      // do not log it twice
      // 如果通过errorHandler处理发生了错误,就直接抛出防止错误被二次打印
      if (e !== err) {
        logError(e, null, 'config.errorHandler')
      }
    }
  }
  logError(err, vm, info)
}

// 输出错误信息
function logError(err, vm, info) {
  // DEV环境下直接发出警告
  if (__DEV__) {
    warn(`Error in ${info}: "${err.toString()}"`, vm)
  }
  // 如果是浏览器环境下且console不为undefined
  // 就直接console.error输出错误信息
  // 否则就抛出
  /* istanbul ignore else */
  if (inBrowser && typeof console !== 'undefined') {
    console.error(err)
  } else {
    throw err
  }
}

0 人点赞