vm.$delete()
vm.$delete用法见官网。
为什么需要Vue.delete()?
在ES6之前, JS没有提供方法来侦测到一个属性被删除了, 因此如果我们通过delete删除一个属性, Vue是侦测不到的, 因此不会触发数据响应式。
见下面的demo。
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<meta http-equiv="X-UA-Compatible" content="ie=edge" />
<title>Vue Demo</title>
<script src="https://cdn.jsdelivr.net/npm/vue"></script>
</head>
<body>
<div id="app">
名字: {{ user.name }} 年纪: {{ user.age }}
<button @click="addUserAgeField">删除一个年纪字段</button>
</div>
<script>
const app = new Vue({
el: "#app",
data: {
user: {
name: "test",
age: 10
}
},
mounted() {},
methods: {
addUserAgeField() {
// delete this.user.age; // 这样是不起作用, 不会触发数据响应式更新
this.$delete(this.user, 'age') // 应该使用
}
}
});
</script>
</body>
</html>
复制代码
源码分析内部实现
源码位置vue/src/core/instance/state.js的stateMixin方法
export function stateMixin (Vue: Class<Component>) {
...
Vue.prototype.$set = set
Vue.prototype.$delete = del
...
}
复制代码
然后查看del函数位置, vue/src/core/observer/index.js。
/**
* Delete a property and trigger change if necessary.
* target: 将被删除属性的目标对象, 可以是对象/数组
* key: 删除属性
*/
export function del (target: Array<any> | Object, key: any) {
// 非生产环境下, 不允许删除一个原始数据类型, 或者undefined, null
if (process.env.NODE_ENV !== 'production' &&
(isUndef(target) || isPrimitive(target))
) {
warn(`Cannot delete reactive property on undefined, null, or primitive value: ${(target: any)}`)
}
// 如果target是数组, 并且key是一个合法索引,通过数组的splcie方法删除值, 并且还能触发数据的响应(数组拦截器截取到变化到元素, 通知依赖更新数据)
if (Array.isArray(target) && isValidArrayIndex(key)) {
target.splice(key, 1)
return
}
// 获取ob
const ob = (target: any).__ob__
// target._isVue: 不允许删除Vue实例对象上的属性
// (ob && ob.vmCount): 不允许删除根数据对象的属性,触发不了响应
if (target._isVue || (ob && ob.vmCount)) {
process.env.NODE_ENV !== 'production' && warn(
'Avoid deleting properties on a Vue instance or its root $data ' +
'- just set it to null.'
)
return
}
// 如果属性压根不在对象上, 什么都不做处理
if (!hasOwn(target, key)) {
return
}
// 走到这一步说明, target是对象, 并且key在target上, 直接使用delete删除
delete target[key]
// 如果ob不存在, 说明target本身不是响应式数据,
if (!ob) {
return
}
// 存在ob, 通过ob里面存储的Dep实例的notify方法通知依赖更新
ob.dep.notify()
}
复制代码
工具函数
// 判断是否v是未定义
export function isUndef (v: any): boolean %checks {
return v === undefined || v === null
}
// 判断v是否是原始数据类型(基本数据类型)
export function isPrimitive (value: any): boolean %checks {
return (
typeof value === 'string' ||
typeof value === 'number' ||
// $flow-disable-line
typeof value === 'symbol' ||
typeof value === 'boolean'
)
}
// 判断对象上是否有属性
const hasOwnProperty = Object.prototype.hasOwnProperty
export function hasOwn (obj: Object | Array<*>, key: string): boolean {
return hasOwnProperty.call(obj, key)
}
复制代码
关于__ob__属性, 在很多源码地方我们都会看到类似这样获取ob(Observer实例)
const ob = (target: any).__ob__
复制代码
牢记只要数据被observe过就会打上这个私有属性, 是在Observer类的构造器里面发生的
export class Observer {
constructor (value: any) {
this.value = value
// 依赖是存在Observe上的dep属性, 再次通知依赖更新时候我们一般使用__ob__.dep.notify()
this.dep = new Dep()
this.vmCount = 0
// 定义__ob__
def(value, '__ob__', this)
if (Array.isArray(value)) {
if (hasProto) {
protoAugment(value, arrayMethods)
} else {
copyAugment(value, arrayMethods, arrayKeys)
}
this.observeArray(value)
} else {
this.walk(value)
}
}
...
}
复制代码
Vue.use()
大家都知道这个方法是用来安装插件的, 是全局api。 具体使用见官网。
通过Vue.use()源码+Vuex部分源码分析插件的安装过程
Vue.use()什么时候被绑在Vue原型上
源码位置: vue/src/core/index.js
Vue
initGlobalAPI()
源码位置: vue/src/core/global-api/index.js
export function initGlobalAPI (Vue: GlobalAPI) {
...
// 初始化use()
initUse(Vue)
...
}
复制代码
initUse()
源码位置: vue/src/core/global-api/use.js
export function initUse (Vue: GlobalAPI) {
// 这里的Vue是构造器函数.
// 通过以下源码:
// vue-dev/src/core/global-api/index.js initGlobalAPI()中
// vue-dev/src/core/index.js 这里执行了initGlobalAPI() => 初始化一些全局api
// Vue.use(): 安装Vue.js的插件
// 如果插件是一个对象,必须提供 install 方法
// 如果插件是一个函数,它会被作为 install 方法
// install 方法调用时,会将 Vue 作为参数传入
Vue.use = function (plugin: Function | Object) {
// installedPlugins存储install后的插件
const installedPlugins = (this._installedPlugins || (this._installedPlugins = []))
if (installedPlugins.indexOf(plugin) > -1) {
// 同一个插件只会安装一次
return this
}
// additional parameters
// 除了插件外的其他参数 Vue.use(MyPlugin, { someOption: true })
const args = toArray(arguments, 1)
// 往args存储Vue构造器, 供插件的install方法使用
args.unshift(this)
// 分情况执行插件的install方法, 把this(Vue), 参数抛回给install方法
// 所以我们常说, install这个方法的第一个参数是 Vue 构造器,第二个参数是一个可选的选项对象:
if (typeof plugin.install === 'function') {
// plugin是一个对象
plugin.install.apply(plugin, args)
} else if (typeof plugin === 'function') {
// plugin是一个函数
plugin.apply(null, args)
}
// install之后会存储该插件避免重复安装
installedPlugins.push(plugin)
return this
}
}
复制代码
Vuex源码
我们都知道开发一个Vue.js 的插件应该暴露一个 install 方法。这个方法的第一个参数是 Vue 构造器,第二个参数是一个可选的选项对象:
那么我们首先就是看Vuex的install方法是怎么实现的
源码位置: vuex-dev/src/store.js
let Vue // bind on install
// install: 装载vuex到vue, Vue.use(Vuex)也是执行install方法
// 关于Vue.use()源码. vue-dev/src/core/global-api/use.js
export function install (_Vue) {
if (Vue && _Vue === Vue) {
if (process.env.NODE_ENV !== 'production') {
console.error(
'[vuex] already installed. Vue.use(Vuex) should be called only once.'
)
}
return
}
// 首次安装插件, 会把局部的Vue缓存到全局的window.Vue. 主要为了避免重复调用Vue.use()
Vue = _Vue
applyMixin(Vue)
}
复制代码
applyMixin()
源码位置: vuex/src/mixin.js
export default function (Vue) {
const version = Number(Vue.version.split('.')[0])
if (version >= 2) {
// 如果是2.x.x以上版本,注入一个全局mixin, 执行vueInit方法
Vue.mixin({ beforeCreate: vuexInit })
} else {
// override init and inject vuex init procedure
// for 1.x backwards compatibility.
// 重写Vue原型上的_init方法, 注入vueinit方法 _init方法见 vue-dev/src/core/instance/init.js
const _init = Vue.prototype._init // 作为缓存变量
Vue.prototype._init = function (options = {}) {
options.init = options.init
? [vuexInit].concat(options.init)
: vuexInit
// 重新执行_init
_init.call(this, options)
}
}
/**
* Vuex init hook, injected into each instances init hooks list.
*/
// 注入store到Vue构造器
function vuexInit () {
// 这里的this. 指的是Vue构造器
/**
* new Vue({
* ...,
* store,
* route
* })
*/
// options: 就是new Vue(options)
// 源码见 vue-dev/src/core/instance/init.js initMixin方法
const options = this.$options
// store injection
// store是我们使用new Vuex.Store(options)的实例
// 注入store到Vue构造函数上的$store属性上, 所以我们在Vue组件里面使用this.$store来使用
if (options.store) {
// options.store为真说明是根节点root
this.$store = typeof options.store === 'function'
? options.store()
: options.store
} else if (options.parent && options.parent.$store) {
// 子组件直接从父组件中获取$store,这样就保证了所有组件都公用了全局的同一份store
this.$store = options.parent.$store
}
}
}
复制代码
至于install方法Vuex是如果执行的?
export class Store {
constructor (options = {}) {
// 浏览器环境下安装vuex
if (!Vue && typeof window !== 'undefined' && window.Vue) {
install(window.Vue)
}
...
}
}
复制代码