Proxy.handler.set

handler.set()?方法用于拦截设置属性值的操作

语法

var p = new Proxy(target, {
  set: function(target, property, value, receiver) {
  }
});

参数

以下是传递给set方法的参数，this上下文绑定在handler对象上.

target目标对象。

property被设置的属性名。

value被设置的新值。

receiver最初被调用的对象。

通常是proxy本身，但handler的set方法也有可能在原型链上或以其他方式被间接地调用（因此不一定是proxy本身）。比如，假设有一段代码执行?obj.name = "jen"，obj不是一个proxy且自身不含name属性，但它的原型链上有一个proxy，那么那个proxy的set拦截函数会被调用，此时obj会作为receiver参数传进来。

返回值

set方法应该返回一个布尔值，返回true代表此次设置属性成功了，如果返回false且设置属性操作发生在严格模式下，那么会抛出一个TypeError。

描述

handler.set?方法用于拦截设置属性值的操作。

拦截

该方法会拦截目标对象的以下操作:

Property assignment: proxy[foo] = bar and proxy.foo = bar

Inherited property assignment: Object.create(proxy)[foo] = bar

Reflect.set()

约束

如果违背以下的约束条件，proxy会抛出一个TypeError:

若目标属性是不可写及不可配置的，则不能改变它的值。

如果目标属性没有配置存储方法，即set方法是undefined的，则不能设置它的值。

在严格模式下，若set方法返回false，则会抛出一个?TypeError 异常。

示例

以下代码演示如何捕获属性的设置操作。

var p = new Proxy({}, {
? set: function(target, prop, value, receiver) {
? ? target[prop] = value
? ? console.log('property set: ' + prop + ' = ' + value)
? ? return true
? }
})

console.log('a' in p) ?// false

p.a = 10 ? ? ? ? ? ? ? // "property set: a = 10"
console.log('a' in p) ?// true
console.log(p.a) ? ? ? // 10

规范

Specification	Status	Comment
ECMAScript 2015 (6th Edition, ECMA-262)The definition of '[Set]' in that specification.	Standard	Initial definition.
ECMAScript Latest Draft (ECMA-262)The definition of '[Set]' in that specification.	Living Standard	?

浏览器兼容性

Feature	Chrome	Firefox (Gecko)	Internet Explorer	Opera	Safari
Basic support	61	18 (18)	?	?	10.1

Feature	Android	Chrome for Android	Firefox Mobile (Gecko)	IE Mobile	Opera Mobile	Safari Mobile
Basic support	?	?	18.0 (18)	?	?	?

本文档系腾讯云开发者社区成员共同维护，如有问题请联系 cloudcommunity@tencent.com

最后更新于：2017-12-18