优雅的处理vue项目异常实战记录

背景

• 你还在为处理uncaught (in promise) referenceerror烦恼吗？
• 你还在为捕获异常反复的写try catch吗？
• 你还在为每一个promise写catch吗？

是时候一站式统一处理异常！！！（针对vue项目）

全局异常捕获

vue.config.errorhandler = function (err, vm, info) {
 // 指定组件的渲染和观察期间未捕获错误的处理函数。这个处理函数被调用时，可获取错误信息和 vue 实例。
 
 // handle error
 // `info` 是 vue 特定的错误信息，比如错误所在的生命周期钩子
 // 只在 2.2.0+ 可用 
}

注意：面对异常处理，同步异常和异步异常应该区别对待分别处理。

vue核心源码剖析

通过阅读源码看一下vue是如何将vue.config.errorhandler接口暴露给使用者。

同步异常处理方案

// 定义异常处理函数，判断用户是否自定义vue.config.errorhandler，定义则直接调用，未定义执行vue本身异常处理。
function globalhandleerror(err, vm, info) {
 if (vue.config.errorhandler) {
  try {
   return config.errorhandler.call(null, err, vm, info)
  } catch (e) {
   logerror(e, null, 'config.errorhandler');
  }
 }
 logerror(err, vm, info);
}
try {
 // vue正常执行代码被包裹在try内，有异常会调用globalhandleerror
} catch (e) {
 globalhandleerror(e, vm, '对应信息');
}

异步异常处理方案

// 定义异步异常处理函数，对于自身没有捕获异常的promise统一执行catch
function invokewitherrorhandling(
 handler,
 context,
 args,
 vm,
 info
) {
 var res;
 try {
  res = args ? handler.apply(context, args) : handler.call(context);
  if (res && !res._isvue && ispromise(res) && !res._handled) {
   res.catch(function (e) { return handleerror(e, vm, info + " (promise/async)"); });
   // 异步代码例如promise可以统一为其定义promise.prototype.catch()方法。
   res._handled = true;
  }
 } catch (e) {
  handleerror(e, vm, info);
 }
 return res
}

// 所有的钩子函数调用异常处理函数
function callhook(vm, hook) {
 var handlers = vm.$options[hook];
 // 为所有钩子增加异常处理
 var info = hook + " hook";
 if (handlers) {
  for (var i = 0, j = handlers.length; i < j; i++) {
   invokewitherrorhandling(handlers[i], vm, null, vm, info);
  }
 }
}

知识延伸

// vue接口是能处理同步异常以及部分钩子中的异步异常，对于方法中的异常无法有效处理，我们可以仿照源码增加方式中的异步异常处理，避免为每一个promise写catch
vue.mixin({
 beforecreate() {
  const methods = this.$options.methods || {}
  object.keys(methods).foreach(key => {
   let fn = methods[key]
   this.$options.methods[key] = function (...args) {
    let ret = fn.apply(this, args)
    if (ret && typeof ret.then === 'function' && typeof ret.catch === "function") {
     return ret.catch(vue.config.errorhandler)
    } else { // 默认错误处理
     return ret
    }
   }
  })
 }
})

完整代码

下面是全局处理异常的完整代码，已经封装成一个插件

errorplugin.js

/**
 * 全局异常处理
 * @param {
 * } error 
 * @param {*} vm 
 */
const errorhandler = (error, vm, info) => {
 console.error('抛出全局异常')
 console.error(vm)
 console.error(error)
 console.error(info)
}
let globalerror = {
 install: (vue, options) => {
 /**
  * 全局异常处理
  * @param {
  * } error 
  * @param {*} vm 
  */
  vue.config.errorhandler = errorhandler
  vue.mixin({
   beforecreate() {
    const methods = this.$options.methods || {}
    object.keys(methods).foreach(key => {
     let fn = methods[key]
     this.$options.methods[key] = function (...args) {
      let ret = fn.apply(this, args)
      if (ret && typeof ret.then === 'function' && typeof ret.catch === "function") {
       return ret.catch(errorhandler)
      } else { // 默认错误处理
       return ret
      }
     }
    })
   }
  })
  vue.prototype.$throw = errorhandler
 }
}
export default globalerror

使用

// 在入口文件中引入
import errorplugin from './errorplugin'
import vue from 'vue'
vue.use(errorplugin)

写在最后

增加全局异常处理有助于

• 提高代码健壮性
• 减少崩溃
• 快速定位bug

资料参考

• cn.vuejs.org/v2/api/#err…

总结

以上就是这篇文章的全部内容了，希望本文的内容对大家的学习或者工作具有一定的参考学习价值，谢谢大家对的支持。