作用:
Object.defineProperty() 该方法允许 精确 添加或修改对象的属性, 并返回这个对象。
和赋值创建的属性区别:
一般情况下,我们为对象添加属性是通过赋值的,比如:obj.name = ‘name’。这些属性是可以被枚举(for…in 或 Object.keys 方法),也可以被改变、被删除。而使用 Object.defineProperty() 则允许改变这些额外细节(下面descriptor参数)的默认设置。例如,默认情况下,使用 Object.defineProperty() 增加的属性值是不可改变的。
格式:
Object.defineProperty(obj, prop, descriptor)
参数:
obj:要在其上定义属性的对象。
prop:要定义或修改的属性的名称。
descriptor:将被定义或修改的属性(prop)的描述符。
返回:*
被传递给函数的对象。
描述符(descriptor)详解:
对象里目前存在的属性描述符有两种主要形式:数据描述符和存取描述符。数据描述符是一个拥有可写或不可写值的属性。存取描述符是由一对 getter-setter 函数功能来描述的属性。描述符必须是两种形式之一;不能同时是两者。
数据描述符同时具有以下可选键值:
value:该属性对应的值。可以是任何有效的 JavaScript 值(数值,对象,函数等)。默认为 undefined
。
var obj = new Object();
Object.defineProperty(obj, 'name', {
value:'name'
});
console.log(obj)
//Object {name: "name"}
writable:当且仅当该属性的 writable 为 true 时,该属性才能被赋值运算符改变。默认为 false
。
var obj = new Object();
Object.defineProperty(obj, 'name', {
value:'name',
writable:false
});
console.log(obj);//Object {name: "name"}
obj.name = 'name2';
console.log(obj)//Object {name: "name"} name属性值没有改变
enumerable:当且仅当该属性的 enumerable 为 true 时,该属性才能够出现在对象的枚举属性中。默认为 false
。
var obj = new Object();
Object.defineProperty(obj, 'name', {
value:'name',
enumerable:false
});
Object.defineProperty(obj, 'age', {
value:2017,
enumerable:true
});
console.log(obj); //Object {age: 2017, name: "name"}
for(var key in obj){
console.log(key) //这里只输出了age这个键值
}
configurable:当且仅当该属性的 configurable 为 true 时,该属性描述符才能够被改变,也能够被删除。默认为 false
。
var obj = new Object();
Object.defineProperty(obj, 'name', {
value:'name',
writable:false,
configurable:false
});
console.log(obj);//Object {name: "name"}
//接下来改变name属性的writable描述符为true
Object.defineProperty(obj, 'name', {
writable:true,
});
//结果报错了 Uncaught TypeError: Cannot redefine property: name at Function.defineProperty (<anonymous>)
//当然不仅仅是writable描述符,value、configurable、enumerable描述符也一样报错
存取描述符同时具有以下可选键值:
configurable:同上
enumerable:同上
get:一个给属性提供 getter 的方法,如果没有 getter 则为 undefined。该方法返回值被用作属性值。默认为 undefined
。
set:一个给属性提供 setter 的方法,如果没有 setter 则为 undefined。该方法将接受唯一参数,并将该参数的新值分配给该属性。默认为 undefined
。
var obj = new Object();
var testVal = 0;
Object.defineProperty(obj, "test", {
get : function(){
return testVal;
},
set : function(val){
testVal = val;
},
enumerable : true,
configurable : true
});
//获取,调用了get方法,返回testVal的值
console.log(obj.test)//0
//赋值,调用了set方法,把testVal值设置为2017
obj.test = 2017;
console.log(testVal);//2017
console.log(obj.test)//2017
注意 注意
1.描述符必须是数据描述符和存取描述符两种形式之一;不能同时是两者
var obj = new Object();
Object.defineProperty(obj, 'name', {
value:'name',//数据描述符
get : function(){//存取描述符
return this;
},
})
//报错了Uncaught TypeError: Invalid property descriptor. Cannot both specify accessors and a value or writable attribute, #<Object> at Function.defineProperty (<anonymous>)
2.如果省略了value,writable,get ,set, 则默认是 数据描述符
3.要注意默认值
var obj = new Object();
Object.defineProperty(obj, "name", {});
等同于
Object.defineProperty(obj, "name", {
value : undefined,
writable : false,
configurable : false,
enumerable : false
});
4.赋值创建属性和defineProperty
var obj = new Object();
obj.age = 2017;
等同于
Object.defineProperty(obj, "age", {
value : 2017,
writable : true,
configurable : true,
enumerable : true
});