JavaScript 中,物件的每個 property 都具備三個屬性:
在 ECMAScript 3 標準中,這三個屬性的值皆為 true 且不可變更:新建的 property 可寫、可枚舉、可刪除。而在 ECMAScript 5 中,可透過屬性描述物件(property descriptor)來設定與修改它們。
若把 property 的值本身也算作屬性,則一個 property 擁有 four 個屬性:value、writable、enumerable 與 configurable。
對於以 getter 和 setter 定義的 property,由於沒有 writable 屬性(可否寫取決於 setter 是否存在),因此它有 get、set、enumerable、configurable 四個屬性,其中 get 和 set 的值為 function。
ES5 中可用 Object.getOwnPropertyDescriptor() 取得物件自身某 property 的屬性資訊:
var o = {x:1};
var a = Object.create(o);
a.y = 3;
console.log(Object.getOwnPropertyDescriptor(a, "y")); // {configurable:true, enumerable:true, writable:true, value:3}
console.log(Object.getOwnPropertyDescriptor(a, "x")); // undefined
可見若 property 不存在或繼承自原型,則回傳 undefined。
ES5 中可用 Object.defineProperty() 設定物件自身某 property 的屬性:
Object.defineProperty(a, "y", {
value: 3,
writable: true,
enumerable: false,
configurable: true
});
console.log(a.propertyIsEnumerable("y")); // false
若所設定的 property 繼承自原型,JavaScript 會在物件自身建立一個同名 property,這與賦值行為一致:
Object.defineProperty(a, "x", {
value: 1,
writable: true,
enumerable: false,
configurable: true
});
console.log(a.propertyIsEnumerable("x")); // false
console.log(o.propertyIsEnumerable("x")); // true
除了修改屬性,也能把 property 改為以 getter/setter 存取:
Object.defineProperty(a, "y", {
get: function(){ return 42; }
});
console.log(a.y); // 42
使用 Object.defineProperty() 時,描述物件中的屬性值可以部分省略,處理規則如下:
若要一次設定多個 property 的屬性,可使用 Object.defineProperties(),它會回傳修改後的物件:
Object.defineProperties(a, {
"y": {value:79, writable:true, enumerable:true, configurable:true},
"z": {value:99, writable:true, enumerable:true, configurable:true}
});
console.log(a); // {y:79, z:99}
修改 property 屬性時必須遵守以下規則,違反者將拋出 TypeError: