Vue.config
是一个对象,包含 Vue 的全局配置。可以在启动应用之前修改下列 property:
silent
- 类型:
boolean
- 默认值:
false
- 用法:取消 Vue 所有的日志与警告。
1
Vue.config.silent = true
optionMergeStrategies
- 类型:
{ [key: string]: Function }
- 默认值:
{}
- 用法:自定义合并策略的选项。
1
2
3
4
5
6
7
8
9Vue.config.optionMergeStrategies._my_option = function (parent, child, vm) {
return child + 1
}
const Profile = Vue.extend({
_my_option: 1
})
// Profile.options._my_option = 2
合并策略选项分别接收在父实例和子实例上定义的该选项的值作为第一个和第二个参数,Vue 实例上下文被作为第三个参数传入。devtools
- 类型:
boolean
- 默认值:
true (生产版为 false)
- 用法:配置是否允许
1
2// 务必在加载 Vue 之后,立即同步设置以下内容
Vue.config.devtools = truevue-devtools
检查代码。开发版本默认为true
,生产版本默认为false
。生产版本设为true
可以启用检查。errorHandler
- 类型:
Function
- 默认值:
undefined
- 用法:指定组件的渲染和观察期间未捕获错误的处理函数。这个处理函数被调用时,可获取错误信息和 Vue 实例。
1
2
3
4
5Vue.config.errorHandler = function (err, vm, info) {
// handle error
// `info` 是 Vue 特定的错误信息,比如错误所在的生命周期钩子
// 只在 2.2.0+ 可用
}从 2.2.0 起,这个钩子也会捕获组件生命周期钩子里的错误。同样的,当这个钩子是
undefined
时,被捕获的错误会通过console.error
输出而避免应用崩溃。
从 2.4.0 起,这个钩子也会捕获 Vue 自定义事件处理函数内部的错误了。
从 2.6.0 起,这个钩子也会捕获 v-on DOM 监听器内部抛出的错误。另外,如果任何被覆盖的钩子或处理函数返回一个 Promise 链 (例如 async 函数),则来自其 Promise 链的错误也会被处理。warnHandler
- 类型:
Function
- 默认值:
undefined
- 用法:为 Vue 的运行时警告赋予一个自定义处理函数。注意这只会在开发者环境下生效,在生产环境下它会被忽略。
1
2
3Vue.config.warnHandler = function (msg, vm, trace) {
// `trace` 是组件的继承关系追踪
}ignoredElements
- 类型:
Array<string | RegExp>
- 默认值:[]
- 用法:须使 Vue 忽略在 Vue 之外的自定义元素 (e.g. 使用了 Web Components APIs)。否则,它会假设你忘记注册全局组件或者拼错了组件名称,从而抛出一个关于 Unknown custom element 的警告。
1
2
3
4
5
6
7Vue.config.ignoredElements = [
'my-custom-web-component',
'another-web-component',
// 用一个 `RegExp` 忽略所有“ion-”开头的元素
// 仅在 2.5+ 支持
/^ion-/
]keyCodes
- 类型:
{ [key: string]: number | Array<number> }
- 默认值:
{}
- 用法:
1
2
3
4
5
6
7
8
9Vue.config.keyCodes = {
v: 86,
f1: 112,
// camelCase 不可用
mediaPlayPause: 179,
// 取而代之的是 kebab-case 且用双引号括起来
"media-play-pause": 179,
up: [38, 87]
}给 v-on 自定义键位别名。1
<input type="text" @keyup.media-play-pause="method">
performance
- 类型:
boolean
- 默认值:
false
(自 2.2.3 起) - 用法:
设置为true
以在浏览器开发工具的性能/时间线面板中启用对组件初始化、编译、渲染和打补丁的性能追踪。只适用于开发模式和支持 performance.mark API 的浏览器
上。
productionTip
- 类型:
boolean
- 默认值:
true
- 用法:
设置为false
以阻止 vue 在启动时生成生产提示。