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 方法用于拦截设置属性值的操作。

拦截

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

  • 指定属性值: proxy[foo] = bar 和 proxy.foo = bar
  • 指定继承者的属性值: 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)
[[Set]]
Standard Initial definition.
ECMAScript Latest Draft (ECMA-262)
[[Set]]
Draft

浏览器兼容性

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!
Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari
Basic support ? 18 (18) ? ? ?
Feature Android Chrome for Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Basic support ? ? 18.0 (18) ? ? ?

另见