专栏分享:vue2源码专栏,vue3源码专栏,vue router源码专栏,玩具项目专栏,硬核💪推荐🙌
欢迎各位ITer关注点赞收藏🌸🌸🌸
背景
以下是柏成根据Vue3官方课程整理的响应式书面文档 - 第二节,课程链接在此:Proxy and Reflect - Vue 3 Reactivity | Vue Mastery
本篇文章将解决 上一篇文章 结尾遗留的问题:如何让代码自动实现响应性? 换句话说就是,如何让我们的 effect
自动保存 & 自动重新运行?
在 上一篇文章 中,我们最终运行的代码长这样
聪明的你会立马发现,我们现在仍要手动调用 track()
来保存 effect
;手动调用 trigger()
来运行 effects
,这不是脱裤子放屁么
我们想让我们的响应性引擎自动调用 track()
和 trigger()
。那么问题就来了,何时才是调用它们的最好时机呢?
从逻辑上来说,如果访问了对象的属性,就是我们调用 track()
去保存 effect
的最佳时机;如果对象的属性改变了,就是我们调用 trigger()
来运行 effects
的最佳时机
所以问题变成了,我们该如何拦截对象属性的访问和赋值操作?
Proxy(代理)
在 MDN 上的 Proxy 对象是这样定义的
Proxy 对象用于创建一个对象的代理,从而实现基本操作的拦截和自定义(如属性查找、赋值、枚举、函数调用等)。
也可以理解为在操作目标对象前架设一层代理,将所有本该我们手动编写的程序交由代理来处理,生活中也有许许多多的"proxy", 如代购,中介,因为他们所有的行为都不会直接触达到目标对象
语法
- target: 要使用 Proxy 包装的目标对象(可以是任何类型的对象,包括原生数组,函数,甚至另一个代理)
- handler: 一个通常以函数作为属性的对象,用来定制拦截行为;它包含有 Proxy 的各个捕获器(trap),例如 handler.get() / handler.set()
javascript
const p = new Proxy(target, handler)
常用方法
比较常用的两个方法就是 get()
和 set()
方法
方法 | 描述 |
---|---|
handler.get(target, key, ?receiver) | 属性读取操作的捕捉器 |
handler.set(target, key, value, ? receiver) | 属性设置操作的捕捉器 |
handler.get
用于代理目标对象的属性读取操作,其接受三个参数 handler.get(target, propKey, ?receiver)
- target: 目标对象
- key: 属性名
- receiver: Proxy 本身或者继承它的对象,后面会重点介绍
举个栗子
javascript
const origin = {}
const obj = new Proxy(origin, {
get: function (target, key, receiver) {
return 10
}
})
obj.a // 10
obj.b // 10
origin.a // undefined
origin.b // undefined
在这个栗子中,我们给一个空对象 origin
的 get
架设了一层代理,所有 get
操作都会直接返回我们定制的数字10
需要注意的是,代理只会对 proxy 对象生效,如访问上方的 origin 对象就没有任何效果
handler.set
用于代理目标对象的属性设置操作,其接受四个参数 handler.set(target, key, value, ?receiver)
- target: 目标对象
- key: 属性名
- value: 新属性值
- receiver: Proxy 本身或者继承它的对象,后面会重点介绍
javascript
const obj = new Proxy({}, {
set: function(target, key, value, receiver) {
target[key] = value
console.log('property set: ' + key + ' = ' + value)
return true
}
})
'a' in obj // false
obj.a = 10 // "property set: a = 10"
'a' in obj // true
obj.a // 10
Reflect(反射)
在 MDN 上的 Reflect 对象是这样定义的
Reflect 是一个内建的对象,用来提供方法去拦截 JavaScript的操作。Reflect 不是一个函数对象,所以它是不可构造的,也就是说你不能通过 new操作符去新建一个 Reflect对象或者将 Reflect对象作为一个函数去调用。Reflect的所有属性和方法都是静态的(就像Math对象)
常用方法
Reflect对象挂载了很多静态方法,所谓静态方法,就是和 Math.round()
这样,不需要 new
就可以直接使用的方法。
比较常用的两个方法就是 get()
和 set()
方法:
方法 | 描述 |
---|---|
Reflect.get(target, key, ?receiver) | 和 target[key] 类似,从对象中读取属性值 |
Reflect.set(target, key, value, ? receiver) | 和 target[key] = value 类似,给对象的属性设置一个新值 |
Reflect.get()
Reflect.get方法允许你从一个对象中取属性值,返回值是这个属性值
Reflect.set()
Reflect.set 方法允许你在对象上设置属性,返回值是 Boolean 值,代表是否设置成功
- target: 目标对象
- key: 属性名
- value: 新属性值
- receiver: 后面会重点介绍
javascript
Reflect.get(target, key[, receiver])
// 等同于
target[key]
Reflect.set(target, key, value[, receiver])
// 等同于
target[key] = value
举个栗子
javascript
let product = {price: 5, quantity: 2}
// 以下三种方法是等效的
product.quantity
product['quantity']
Reflect.get(product, 'quantity')
// 以下三种方法是等效的
product.quantity = 3
product['quantity'] = 3
Reflect.set(product, 'quantity', 3)
关于receiver参数
在 Proxy 和 Reflect 对象中 get/set()
方法的最后一个参数都是 receiver
,它到底是个什么玩意?
receiver 是接受者的意思,译为接收器
- 在 Proxy trap 的场景下(例如 handler.get() / handler.set()),
receiver
永远指向 Proxy 本身或者继承它的对象,比方说下面这个例子
javascript
let origin = { a: 1 }
let p = new Proxy(origin, {
get(target, key, receiver) {
return receiver
},
})
let child = Object.create(p)
p.getReceiver // Proxy {a: 1}
p.getReceiver === p // true
child.getReceiver // {}
child.getReceiver === child // true
- 在 Reflect.get / Reflect.set() 的场景下,
receiver
可以改变计算属性中this
的指向
javascript
let target = {
firstName: 'li',
lastName: 'baicheng',
get a() {
return `${this.firstName}-${this.age}`
},
set b(val) {
console.log('>>>this', this)
this.firstName = val
},
}
Reflect.get(target, 'a') // li-undefined
Reflect.get(target, 'a', { age: 24 }) // undefined-24
Reflect.set(target, 'b', 'huawei', { age: 24 })
// >>>this {age: 24}
// true
搭配Proxy
在 Proxy 里使用 Reflect,我们会有一个附加参数,称为 receiver
(接收器),它将传递到我们的 Reflect调用中。它保证了当我们的对象有继承自其它对象的值或函数时, this
指针能正确的指向对象,这将避免一些我们在 vue2 中有的响应式警告
javascript
let origin = { a: 1 }
let p = new Proxy(origin, {
get(target, key, receiver) {
return Reflect.get(target, key, receiver)
},
set(target, key, value, receiver) {
return Reflect.set(target, key, value, receiver)
},
})
Reflect对象经常和Proxy代理一起使用,原因有三点:
-
Reflect提供的所有静态方法和Proxy第2个handle对象中的方法参数是一模一样的,例如Reflect的
get/set()
方法需要的参数就是Proxyget/set()
方法的参数 -
Proxy
get/set()
方法需要的返回值正是Reflect的get/set()
方法的返回值,可以天然配合使用,比直接对象赋值/获取值要更方便和准确 -
receiver 参数具有不可替代性!!!
在下面示例中,我们在页面中访问了 alias 对应的值,稍后 name 变化了,要重新渲染么?
target[key] 方式访问 proxy.alias 时,获取到 this.name,此时 this 指向 target,无法监控到 name ,不能重新渲染
Reflect 方式访问 proxy.alias 时,获取到 this.name,此时 this 指向 proxy,可监控到 name ,可以重新渲染
javascript
const target = {
name: '柏成',
get alias() {
console.log('this === target', this === target)
console.log('this === proxy', this === proxy)
return this.name
},
}
const proxy = new Proxy(target, {
get(target, key, receiver) {
console.log('key:', key)
return target[key]
// return Reflect.get(target, key, receiver)
},
set(target, key, value, receiver) {
return Reflect.set(target, key, value, receiver)
},
})
proxy.alias
使用 target[key] 打印结果:
使用 Reflect 打印结果:
如何用(How)
让我们创建一个称为 reactive
的函数,如果你使用过Composition API,你会感觉很熟悉。然后再封装一下我们的 handler
方法,让它长得更像 Vue3 的源代码,最后我们将创建一个新的 Proxy对象
代码如下
javascript
function reactive(target) {
const handler = {
get(target, key, receiver) {
let result = Reflect.get(target, key, receiver)
// 保存effect
track(target, key)
return result
},
set(target, key, value, receiver) {
let oldValue = target[key]
let result = Reflect.set(target, key, value, receiver)
if (oldValue !== value) {
// 运行effect
trigger(target, key)
}
return result
},
}
return new Proxy(target, handler)
}
let product = reactive({ price: 5, quantity: 2 })
现在我们已经不再需要手动调用 track()
和 trigger()
了
让我们分析一下上图内容
-
现在我们的响应式函数返回一个 product 对象的代理,我们还有变量 total ,方法 effect() 。
-
当我们运行 effect() ,试图获取 product.price 时,它将运行
track(product, 'price')
-
在 targetMap 里,它将为 product 对象创建一个新的映射,它的值是一个新的 depsMap ,这将映射 price 属性得到一个新的 dep ,这个 dep 就是一个 effects 集(Set),把我们 total 的 effect 加到这个集(Set)中
-
我们还会访问 product.quantity ,这是另一个get请求。我们将会调用
track(product, 'quantity')
。这将访问我们 product 对象的 depsMap ,并添加一个 quantity 属性到一个新的 dep 对象的映射 -
然后我们把 total 打印到控制台是 10
-
然后我们运行
product.quantity = 3
,它会调用trigger(product, 'quantity')
,然后运行被存储的所有 effect -
调用 effect() , 就会访问到 product.price ,触发
track(product, 'price')
;访问到 product.quantity ,则触发track(product, 'quantity')
ActiveEffect
我们每访问一次Proxy实例属性,都将会调用一次 track
函数。然后它会去历遍 targetMap、depsMap,以确保当前 effect
会被记录下来,这不合理,不需要多次添加 effect
这不是我们想要的,我们只应该在 effect()
里调用 track
函数
javascript
console.log('Update quantity to = '+ product.quantity)
console.log('Update price to = '+ product.price)
为此,我们引入了 activeEffect
变量,它代表现在正在运行中的 effect
, Vue3 也是这样做的,代码如下
javascript
let activeEffect = null
...
// 负责收集依赖
function effect(eff){
activeEffect = eff
activeEffect() // 运行
activeEffect = null //复位
}
// 我们用这个函数来计算total
effect(() => {
total = product.price * product.quantity
})
现在我们需要新的 track()
函数,让它去使用这个新的 activeEffect
变量
javascript
function track(target, key){
// 关键!!!
// 我们只想在我们有activeEffect时运行这段代码
if(!activeEffect) return
let depsMap = targetMap.get(target)
if (!depsMap) {
targetMap.set(target, (depsMap = new Map()))
}
let dep = depsMap.get(key)
if (!dep) {
depsMap.set(key, (dep = new Set()))
}
//当我们添加依赖(dep)时我们要添加activeEffect
dep.add(activeEffect)
}
这样就保证了,如果不是通过 effect()
函数去访问 Proxy实例属性,则这时的 activeEffect
为 null ,进入 track()
函数立即就被 return 掉了
完整代码
这样一来,我们就实现了 Vue3 基本的响应性了。完整代码如下
javascript
// The active effect running
let activeEffect = null
// For storing the dependencies for each reactive object
const targetMap = new WeakMap()
// 负责收集依赖
function effect(eff) {
activeEffect = eff
activeEffect() // 运行
activeEffect = null //复位
}
// Save this code
function track(target, key) {
// 关键!!!
// 我们只想在我们有activeEffect时运行这段代码
if (!activeEffect) return
let depsMap = targetMap.get(target)
if (!depsMap) {
targetMap.set(target, (depsMap = new Map()))
}
let dep = depsMap.get(key)
if (!dep) {
depsMap.set(key, (dep = new Set()))
}
console.log('>>>track', target, key)
//当我们添加依赖(dep)时我们要添加activeEffect
dep.add(activeEffect)
}
// Run all the code I've saved
function trigger(target, key) {
const depsMap = targetMap.get(target)
if (!depsMap) {
return
}
let dep = depsMap.get(key)
if (dep) {
console.log('>>>trigger', target, key)
dep.forEach(eff => {
eff()
})
}
}
// 响应式代理
function reactive(target) {
// 如果不是对象或数组
// 抛出警告,并返回目标对象
if (!target || typeof target !== 'object') {
console.warn(`value cannot be made reactive: ${String(target)}`)
return target
}
const handler = {
get(target, key, receiver) {
let result = Reflect.get(target, key, receiver)
track(target, key)
// 递归创建并返回
if (typeof target[key] === 'object' && target[key] !== null) {
return reactive(target[key])
}
return result
},
set(target, key, value, receiver) {
let oldValue = target[key]
let result = Reflect.set(target, key, value, receiver)
if (oldValue !== value) {
trigger(target, key)
}
return result
},
}
return new Proxy(target, handler)
}
let product = reactive({ price: 5, quantity: 2, rate: { value: 0.9 } })
let total = 0
effect(() => {
total = product.price * product.quantity * product.rate.value
})
控制台打印结果如下