Proxy 对象
Proxy 意为"代理器"，用于修改目标对象的成员之前进行"拦截"，外界对该对象的成员的访问，都必须先通过这层拦截。其中，成员包括未定义的，即访问或设置不存在的属性，也会触发相应的代理函数。
初步认识
创建
通过构造函数可以创建 Proxy 对象（new Proxy()），需要依次传入两个参数：
- 被代理的目标对象。可以是任意类型的对象，包括数组、函数等，甚至是另一个 Proxy 对象。
- 控制器对象。控制器是一个对象，内部定义零个或多个代理函数。若控制器为空对象，等同于直接访问目标对象。
下面给出简单的例子：
let obj = { a: 1 }
let proxy = new Proxy(obj, {
get(obj, prop) {
return 'proxyReturn'
}
});
console.log(proxy.a); // 'proxyReturn'
console.log(proxy.b); // 'proxyReturn'复制代码例子中，proxy对obj对象拦截，访问其属性时，永远返回的是'proxyReturn'，即使属性是不存在。而get函数是众多代理函数中的一种，下面会分别介绍其他的代理函数。
作为 prototype 的情况
有一种情况，Proxy 对象作为某个对象的原型。看下面例子：
let proxy = new Proxy({}, {
get(obj, prop) {
return 'proxyReturn'
}
});
let obj = { a: 1 }
Object.setPrototypeOf(obj, proxy);
console.log(obj.a); // 1
console.log(obj.b); // 'proxyReturn'复制代码当访问obj.b时，由于b在obj对象内不存在，因此会到访问原型是否存在该属性，即访问了proxy对象，从而触发了代理函数。
注意
代理对象必须与被代理的对象具有相同特性（这里说的特性指的是，对象是否冻结，是否密封，是否可扩展），即被代理的对象不能修改，使用代理对象的set方法也会报错。再例如，被代理的对象被冻结，get方法不能返回与原值不同的值；getOwnPropertyDescriptor必须返回描述符对象。总之一句，被代理对象不能改的，代理对象同样不能改；代理对象的方法的返回值类型必须与被代理对象一致。
控制器对象内方法的 this
控制器对象内方法的this指向控制器对象本身，看如下例子：
let handler = {
get() {
return this
}
}
let proxy = new Proxy({}, handler);
console.log(proxy.a === handler); // true复制代码
控制器对象
上面提到，控制器对象可以包含零个或多个的代理函数。像get这样的代理函数，一共有 13 个。简单介绍下面出现的参数名意义：
- target：表示被代理的对象。
- propKey：表示属性名（或方法名）。
- receiver：表示该方法所在的代理对象。
get(target, propKey, receiver)
get方法用于拦截某个成员的读取操作（包括方法），上面已经简单给出了例子。下面给出代理数组的例子，使其可以用负数索引。
let arr = [1, 2, 3, 4, 5];
let proxy = new Proxy(arr, {
get(target, prop) {
let length = target.length,
index = Number.parseInt(prop);
if (index < 0) {
return target[length + index]
}
if (index >= length) {
return target[length - 1]
}
return target[index]
}
});
console.log(proxy[-1]); // 5
console.log(proxy[10]); // 5
console.log(proxy[2]); // 3复制代码set(target, propKey, value, receiver)
set方法用于拦截对象属性的设置。其中，value表示属性的目标值。比较实用的用法是，与 DOM 的数据绑定。
需要注意的是！当存在二级属性时，如[{}, {}]或{ a: {}, b: {} }，对二级或以上的属性修改并不会触发set方法。
如下例子：
let listData = ['one', 'two', 'three'];
let proxy = new Proxy(listData, {
set(target, prop, value) {
let dom = document.getElementsByClassName('list-item')[prop]
dom ? dom.innerText = value : null;
target[prop] = value;
}
})
proxy[0] = 'changed-one';复制代码
has(target, propKey)
has方法用来拦截HasProperty操作，即判断对象是否具有某个属性时，这个方法会生效。典型的操作就是in运算符。
注意，hasOwnProperty()和for...in都不能触发has方法。
注意，has方法只能返回布尔值，return非布尔值会自动转成布尔值。
let arr = [1, 2, 3, 4];
let proxyArr = new Proxy(arr, {
has(target, prop) {
return 'a'
}
})
console.log('x' in proxyArr); // true复制代码deleteProperty(target, propKey)
deleteProperty方法用于拦截delete操作，只能返回布尔值，非布尔值会被转成布尔值，代表属性是否被删除成功，省略默认返回false。
let obj = { a: 1, b: 2 }
let proxyDel = new Proxy(obj, {
deleteProperty(target, prop) {
delete target[prop]
}
});
console.log(delete proxyDel.a); // false
console.log(obj); // { b: 2 }复制代码getOwnPropertyDescriptor(target, propKey)
getOwnPropertyDescriptor方法拦截Object.getOwnPropertyDescriptor()或Object.getOwnPropertyDescriptors()，返回一个属性描述对象或者undefined。
注意，若返回值不是undefined，则返回值必须是包含[[configurable]]为true的对象，该值为false或省略会导致报错；若其他描述符未定义，以默认值填充；若返回对象包含除描述符以外的属性，则该属性被忽略。
// undefined
let proxy1 = new Proxy({}, {
getOwnPropertyDescriptor(target, prop) {
return undefined
}
});
console.log(Object.getOwnPropertyDescriptor(proxy1, 'a'));
// { value: undefined, writable: false, enumerable: false, configurable: true }
let proxy2 = new Proxy({}, {
getOwnPropertyDescriptor(target, prop) {
return { configurable: true }
}
});
console.log(Object.getOwnPropertyDescriptor(proxy2, 'a'));
// 报错
let proxy3 = new Proxy({}, {
getOwnPropertyDescriptor(target, prop) {
return { configurable: false }
}
});
console.log(Object.getOwnPropertyDescriptor(proxy3, 'a'));复制代码defineProperty(target, propKey, propDesc)
defineProperty方法拦截Object.defineProperty()、Object.defineProperties()、obj.prop = 'value'等修改/添加对象的属性的操作。该方法只能返回布尔值，非布尔值会转成布尔值，表示是否成功定义属性，返回fasle会导致报错。其中，propDesc表示属性的描述符。
注意，如果对象被冻结（Object.freeze()）或对象被密封（Object.seal()）或对象不可扩展（ Object.preventExtensions()），甚至是某个属性被密封（[[configurable]]特性为false），对代理对象使用Object.defineProperty()都可能会报错。总之，和原对象的特性一致，不能被修改的被代理后同样不能被修改。
let obj = { d: 4 }
let proxyObj = new Proxy(obj, {
defineProperty() {
console.log('proxy-defineProperty');
return true
}
})
// 以下4种方法都会触发 defineProperty 方法
Object.defineProperty(proxyObj, 'a', {});
Object.defineProperties(proxyObj, { b: {} });
proxyObj.c = 3;
proxyObj.d = 5;复制代码apply(target, object, args)
apply方法拦截函数的调用、call、apply、bind操作。其中，object表示函数上下文对象，args表示函数的参数。
let obj = { a: 10 }
function fn() { }
let proxyFn = new Proxy(fn, {
apply(target, object, args) {
console.log('proxyFn-apply');
}
})
// 直接执行函数 会触发
proxyFn();
// apply 和 call 会触发
proxyFn.apply(obj);
proxyFn.call(obj);
// bind 定义时不会触发 执行时触发
let p = proxyFn.bind(obj);
p();复制代码construct(target, args, receiver)
construct方法用于拦截new命令。
注意，被代理的函数不能是箭头函数，否则也会报错。
注意，construct方法必须要return对象（包括函数、数组等），否则会报错。
// 错误例子1
let P1 = new Proxy(()=>{},{
construct(){
return {}
}
});
let p1 = new P1(); // 报错,被代理函数不能是箭头函数
// 错误例子2
let P2 = new Proxy(function(){},{
construct(){}
});
let p2 = new P2(); // 报错,construct必须返回对象复制代码getPrototypeOf(target)
getPrototypeOf方法主要用来拦截获取对象原型，返回值必须是null或对象。具体来说，拦截下面这些操作。
Object.prototype.__proto__// 只能在浏览器环境下执行Object.prototype.isPrototypeOf()// 代理对象作为参数Object.getPrototypeOf()// 代理对象作为参数Reflect.getPrototypeOf()// 代理对象作为参数instanceof// 代理对象在运算符的左边
下面给出简单例子：
let proxy = new Proxy({},{
getPrototypeOf(){
console.log('proxy-getPrototypeOf');
return null
}
});
// 都会打印 'proxy-getPrototypeOf'
let x1 = proxy.__proto__; // 只能在浏览器下执行
let x2 = {}.isPrototypeOf(proxy);
let x3 = Object.getPrototypeOf(proxy);
let x4 = Reflect.getPrototypeOf(proxy);
let x5 = (proxy instanceof function(){});复制代码setPrototypeOf(target, proto)
setPrototypeOf方法主要用来拦截Object.setPrototypeOf()方法。和Object.setPrototypeOf()方法一样，必须返回被设置的对象，否则报错。其中，proto表示被设为原型的对象。
注意，浏览器环境下可以通过__proto__设置原型对象，同样能触发setPrototypeOf方法。
let proxy = new Proxy({}, {
setPrototypeOf(target, proto) {
console.log('proxy-setPrototypeOf')
return target;
}
});
// 都打印 'proxy-setPrototypeOf'
Object.setPrototypeOf(proxy, {});
proxy.__proto__ = {} // 非浏览器环境下使用会报错复制代码isExtensible(target)
isExtensible方法拦截Object.isExtensible()方法，必须返回布尔值，非布尔值会被转成布尔值，且返回值必须与源对象所对应的值相同，否则报错。
// 错误示范
let proxy = new Proxy({}, {
isExtensible() {
return false
}
});
console.log(Object.isExtensible(proxy));复制代码preventExtensions(target)
preventExtensions方法拦截Object.preventExtensions()方法，只能返回被设为不可扩展的被代理对象，否则报错。如下：
let proxy = new Proxy({}, {
preventExtensions(target) {
console.log('proxy-preventExtensions')
return Object.preventExtensions(target);
}
});
Object.preventExtensions(proxy); // proxy-preventExtensions
// 错误示范
let proxyErr = new Proxy({}, {
preventExtensions(target) {
return {}
}
});
Object.preventExtensions(proxyErr); // 报错复制代码ownKeys(target)
ownKeys方法用来拦截对象自身所有属性的读取操作，必须返回数组或对象，否则报错。具体来说，拦截以下操作。
Object.getOwnPropertyNames()。Object.getOwnPropertySymbols()。getOwnPropertyDescriptors()。Object.entries()、Object.keys()、Object.values()。for...in循环。
注意，虽然可以返回非数组的对象，对于如Object.keys这种默认返回数组的方法，得到的结果会是一个空数组。
注意，诸如Object.entries方法返回的数组不会含有Symbol属性名、不存在的属性名、不可遍历（enumerable）的属性名，与被代理对象的行为一致。Object.getOwnPropertySymbols及其他方法同理，与被代理对象一致。
看下面简单例子：
let proxy = new Proxy({ a: 1, b: 2 }, {
ownKeys() {
console.log('proxy-ownKeys');
return ['a', 'c']
}
});
// 都会打印 'proxy-ownKeys'
let x1 = Object.entries(proxy);
let x2 = Object.keys(proxy);
let x3 = Object.values(proxy);
for (let x4 in proxy) { }
let x5 = Object.getOwnPropertyNames(proxy);
let x6 = Object.getOwnPropertyDescriptors(proxy);
let x7 = Object.getOwnPropertySymbols(proxy);
// entries、keys、values 都会过滤不可能显示的属性，跟被代理对象一致
console.log(x1); // [ [ 'a', 1 ] ]
复制代码
Proxy.revocable()
Proxy.revocable()方法与new Proxy()用法类似，都是依次传入被代理对象和控制器对象，返回一个包含proxy对象和revoke方法的对象。其中，proxy对象和上面描述的一致，revoke方法用于解除proxy对象的代理，一旦取消将无法继续使用。
let proxyR = Proxy.revocable({ a: 1 }, {});
console.dir(proxyR); // { proxy: { a: 1 }, revoke: [Function] }
console.log(proxyR.proxy); // { a: 1 }
proxyR.revoke();
// console.log(proxyR); // 报错复制代码
作者：hozee的笔记
链接：https://juejin.im/post/5ce69c926fb9a07ed657ac43
来源：掘金
著作权归作者所有。商业转载请联系作者获得授权，非商业转载请注明出处。