Vue常见异常处理技巧

常见5中Vue异常报错处理

常见错误

第一种：引用一个不能存在的变量：

<div id="app" v-cloak>
  Hello, {{text}}
</div

上述代码运行后不会抛出错误，但是在控制台会有[Vue warn]消息。

第二种：将变量绑定到一个被计算出来的属性，计算的时候会抛出异常。

<div id="app" v-cloak>
  Hello, {{text2}}
</div>

<script>
const app = new Vue({
  el:'#app',
  computed:{
    name2() {
      return x;
    }
  }
})
</script>

运行上述代码会在控制台抛出一个[Vue warn]和一个常规的错误，网页白屏。

第三种：执行一个会抛出异常的方法

<div id="app" v-cloak>
	<button @click="doIt">Do It</button>
</div>

<script>
const app = new Vue({
  el:'#app',
  methods:{
	  doIt() {
		  return x;
	  }
  }
})
</script>

这个错误在控制台也[Vue warn]和常规报错。和上一个错误的区别在于，只有你点击了按钮才会触发函数调用，才会报错。
上述这几个错误是Vue常见的异常抛出，但是在官方文档中我们很少能看到有具体的解决方式，有的仅仅只是一个简单的说明
《---------------------
如果在组件渲染时出现运行错误，错误将会被传递至全局 Vue.config.errorHandler 配置函数 (如果已设置)。利用这个钩子函数来配合错误跟踪服务是个不错的主意。比如 Sentry，它为 Vue 提供了官方集成
-----------》
总提来说Vue中异常处理包含以下几个方面的技巧
errorHandler
warnHandler
renderError
errorCaptured
window.onerror (不仅仅针对Vue)
技巧1：errorHandler

我们要学习的第一个技巧是errorHandler。你也许知道，这是Vue中最广泛使用的异常处理方式。

Vue.config.errorHandler = function(err, vm, info) {
}

err指代error对象，info是一个Vue特有的字符串，vm指代Vue应用本身。记住在一个页面你可以有多个Vue应用。这个error handler作用到所有的应用。

Vue.config.errorHandler = function(err, vm, info) {
  console.log(`Error: ${err.toString()}\nInfo: ${info}`);
}

第一种错误不会触发errorHandler，它只是一个warning。
第二种错误会抛出错误被errorHandler捕获：

Error: ReferenceError: x is not defined
Info: render

第三种错误也会被捕获：

Error: ReferenceError: x is not defined
Info: v-on handler

记住info里面的信息也是非常有用的。

技巧2: warnHandler
warnHandler用来捕获Vue warning。记住在生产环境是不起作用的。

Vue.config.warnHandler = function(msg, vm, trace) {

}

msg和vm都容易理解，trace代表了组件树。请看下面的例子：

Vue.config.warnHandler = function(msg, vm, trace) {
  console.log(`Warn: ${msg}\nTrace: ${trace}`);
}

第一个错误被warnHandler捕获：

Warn: Property or method 'name' is not defined on the instance but referenced during render. Make sure that this property is reactive, either in the data option, or for class-based components, by initializing the property. See: https://vuejs.org/v2/guide/reactivity.html#Declaring-Reactive-Properties.

技巧3: renderError
和前面两个不同，这个技巧不适用于全局，和组件相关。并且只适用于非生产环境。
下面是一个简单的例子：

const app = new Vue({
  el:'#app',
  renderError (h, err) {
    return h('pre', { style: { color: 'red' }}, err.stack)
  }
})

第一个例子是没有效果的，因为只是一个warning。第二个例子就会在网页上显示具体的错误信息:

ReferenceError: x is not defined
    at Vue.text2 (pen.js:43:7)
    at Watcher.get (https://unpkg.com/[e-mail]/dist/vue.js:4472:27)
    at Watcher.evaluate (https://unpkg.com/[e-mail]/dist/vue.js:4577:23)
    at Proxy.computedGetter (https://unpkg.com/[e-mail]/dist/vue.js:4826:19)
    at Proxy.eval (eval at createFunction (https://unpkg.com/[e-mail]/dist/vue.js:11628:14), <anonymous>:3:68)
    at Vue._render (https://unpkg.com/[e-mail]/dist/vue.js:3545:24)
    at Vue.updateComponent (https://unpkg.com/[e-mail]/dist/vue.js:4061:23)
    at Watcher.get (https://unpkg.com/[e-mail]/dist/vue.js:4472:27)
    at new Watcher (https://unpkg.com/[e-mail]/dist/vue.js:4461:14)
    at mountComponent (https://unpkg.com/[e-mail]/dist/vue.js:4068:5)

技巧4: errorCaptured
errorCaptured是最后一个和Vue相关的技巧，这个技巧让我很迷惑，现在还是有点搞不明白。文档是这么介绍的：

当捕获一个来自子孙组件的错误时被调用。此钩子会收到三个参数：错误对象、发生错误的组件实例以及一个包含错误来源信息的字符串。此钩子可以返回 false 以阻止该错误继续向上传播。

这个error Handler只能在父组件中处理子组件的错误。据我所知，我们没法直接在Vue的主实例(main instance)中使用它。

Vue.component('cat', {
  template:`
<div><h1>Cat: </h1>
  <slot></slot>
</div>`,
  props:{
    name:{
      required:true,
      type:String
    }
  },
   errorCaptured(err,vm,info) {
    console.log(`cat EC: ${err.toString()}\ninfo: ${info}`); 
     return false;
  }

});

Vue.component('kitten', {
  template:'<div><h1>Kitten: {{ dontexist() }}</h1></div>',
  props:{
    name:{
      required:true,
      type:String
    }
  }
});

注意 kitten 组件的代码是有BUG的。

<div id="app" v-cloak>
  <cat name="my cat">
      <kitten></kitten>
  </cat>
</div>

捕获的信息如下:

cat EC: TypeError: dontexist is not a function
info: render

运行实例

Vue.config.productionTip = false;
Vue.config.devtools = false;
/*
Vue.config.errorHandler = function(err, vm, info) {  
  console.log('ERROR', err.toString(), ' and info=', info);  
}
*/
Vue.config.warnHandler = function(msg, vm, trace) {
  console.log('WARN ',msg,' and trace=',trace);
}

Vue.component('cat', {
  template:`
<div><h1>Cat: {{name}}</h1>
  <slot></slot>
</div>`,
  props:{
    name:{
      required:true,
      type:String
    }
  },
   errorCaptured(err,vm,info) {
    console.log(`cat EC: ${err.toString()}\ninfo: ${info}`); 
     return false;
  }

});

Vue.component('kitten', {
  template:'<div><h1>Kitten: {{ dontexist() }}</h1></div>',
  props:{
    name:{
      required:true,
      type:String
    }
  }
});

Erro:Cat: my cat
errorCaptured是个很有趣的特性，我想哪些构建组件库的开发者应该会用到吧。这个特性更像是一个面向组件开发者而不是一般开发者。
重量级技巧: window.onerror
最后也是最重要的一个候选项 window.onerror。它是一个全局的异常处理函数，可以抓取所有的JavaScript异常。

window.onerror = function(message, source, line, column, error) {

}

我想函数的参数中只有source难以从字面上理解吧，它代表了当前的URL。
接下来事情就比较好玩了。如果你定义了onerror，但是没有启用Vue.config.errorHandler，那么有很多异常都抓不到。Vue希望你要定义它，否则异常不会抛出去的。这到底有没有意义？我不是很懂，我觉得没必要，甚至有点奇怪。
如果定义errorHandler的代码有BUG，那么运行起来也不会被onerror抓到。下面的例子中，如果将oopsIDidItAgain()解注释，你就会发现这个问题。只有第二个按钮没有和Vue绑定，所以报错无论如何都会被抓到。
运行实例

window.onerror = function(message, source, line, column, error) {
  console.log('ONE ERROR HANDLER TO RULE THEM ALL:', message);
}

Vue.config.productionTip = false;
Vue.config.devtools = false;

Vue.config.errorHandler = function(err, vm, info) {
  //oopsIDidItAgain();
  console.log(`Error: ${err.toString()}\nInfo: ${info}`);
}

const app = new Vue({
  el:'#app',
  methods:{
    doIt() {
      return x;
    }
  }
})