Object.defineProperty

Object.defineProperty方法

方法原型

Object.defineProperty 提供一种直接的方式来定义对象属性或者修改已有对象属性，方法原型如下:

Object.defineProperty(obj,prop,descriptor)

参数

obj:必须，要在其上添加或修改属性的对象。

prop:必须，待修改的属性名称

descriptor: 待修改属性的相关描述

descriptor 要求传入一个对象，其默认值如下：

{
configurable: false,
enumerable: false,
writable: false,
value: null,
set: undefined,
get: undefined
}

configurable: 属性是否可配置。可配置的含义包括：是否可以删除属性（ delete ），是否可以修改属性的 writable 、 enumerable 、 configurable 属性。
enumerable: 属性是否可枚举。可枚举的含义包括：是否可以通过 for...in 遍历到，是否可以通过 Object.keys() 方法获取属性名称。
writable: 属性是否可重写。可重写的含义包括：是否可以对属性进行重新赋值。
value: 属性的默认值。
set: 属性的重写器（暂且这么叫）。一旦属性被重新赋值，此方法被自动调用。
get: 属性的读取器（暂且这么叫）。一旦属性被访问读取，此方法被自动调用。

返回值

已修改的对象

备注

Object.defineProperty函数可执行的操作包括如下：

当对象不具有指定的属性名称时，向对象添加新属性。

当对象具有指定的属性名称时，修改现有的属性。

如果要同时修改多个属性，则可以用Object.defineProperties。

异常情况

obj参数不是对象。

此对象不可扩展且属性名称不存在 （Object.preventExtensions，Object.seal，Object.freeze可阻止对象的扩展）。

descriptor 具有 value 或 writable 特性，并且具有 get 或 set 特性。

descriptor 具有 get 或 set 特性，上述特性不是函数且已定义。

示例代码

列出对象属性
var names = Object.getOwnPropertyNames(obj);
for (var i = 0; i < names.length; i++) {
var prop = names[i];
document.write(prop + ': ' + obj[prop]);
document.write(newLine);
}
列出对象属性的特性
var descriptor = Object.getOwnPropertyDescriptor(obj, ＂ｎａｍｅ");
for (var prop in descriptor) {
document.write(prop + ': ' + descriptor[prop]);
document.write(newLine);
}

Object.defineProperty() 方法设置属性时，属性不能同时声明访问器属性（ set 和 get ）和 writable 或者 value 属性。 意思就是，某个属性设置了 writable 或者 value 属性，那么这个属性就不能声明 get 和 set 了，反之亦然。

var o = {},
myName = 'erik';
Object.defineProperty(o, 'name', {
value: myName,
set: function(name) {
myName = name;
},
get: function() {
return myName;
}
});

这种情况下，会报错

Uncaught TypeError: Invalid property. A property cannot both have accessors and be writable or have a value, #<Object>(…)

修改 DOM 元素上的属性
var descriptor = Object.getOwnPropertyDescriptor(Element.prototype, "querySelector");
descriptor.value = "query";
descriptor.writable = false;
Object.defineProperty(Element.prototype, "querySelector", descriptor);
var elem = document.getElementById("div");
elem.querySelector = "anotherQuery";
document.write(elem.querySelector);
输出为ｑｕｅｒｙ