ES5 引入屬性描述符,賦予開發者對物件屬性精細的控制權:唯讀、不可列舉、不可配置、存取器等。本文從 Object.defineProperty 切入,詳細說明資料描述符、存取描述符、取得描述符、物件鎖定三大機制。
Object.defineProperty(obj, prop, descriptor)
// obj: 目標物件
// prop: 屬性名稱 (字串或 Symbol)
// descriptor: 描述符物件
| 鍵名 | 型別 | 預設 | 說明 |
|---|---|---|---|
value | 任何 | undefined | 屬性值 |
writable | Boolean | false | 是否可寫入 |
enumerable | Boolean | false | 是否出現在 for...in / Object.keys |
configurable | Boolean | false | 是否可刪除或修改描述符 |
var obj = {};
Object.defineProperty(obj, 'PI', {
value: 3.14159,
writable: false, // 嚴格模式下寫入會拋 TypeError
configurable: true, // 允許後續修改描述符
enumerable: true
});
obj.PI = 3; // 非嚴格模式靜默失敗,嚴格模式拋錯
Object.defineProperty(obj, 'secret', {
value: 'hide me',
enumerable: false
});
for (var k in obj) console.log(k); // 不會印出 secret
Object.keys(obj); // 不包含 secret
Object.defineProperty(obj, 'x', { value: 1, writable: false, configurable: true });
Object.defineProperty(obj, 'x', { writable: true }); // 成功
obj.x = 2; // 成功
使用 get/set 定義存取器,**不可與 value/writable 同時存在**。
var obj = { _age: 0 };
Object.defineProperty(obj, 'age', {
get: function() { return this._age; },
set: function(v) { this._age = Math.max(0, v); }, // 不允許負數
enumerable: true,
configurable: true
});
obj.age = -5; // 實際存 0
console.log(obj.age); // 0
var desc = Object.getOwnPropertyDescriptor(obj, 'age');
console.log(desc);
// { get: [Function], set: [Function], enumerable: true, configurable: true }
| 方法 | 效果 | 檢查方法 |
|---|---|---|
Object.preventExtensions(obj) | 禁止新增屬性 | Object.isExtensible(obj) |
Object.seal(obj) | 禁止新增/刪除屬性,現有屬性 configurable=false | Object.isSealed(obj) |
Object.freeze(obj) | 完全凍結:不可新增/刪除/修改(含 writable=false) | Object.isFrozen(obj) |
defineProperty,不支援一般物件class、Proxy、Object.defineProperties 等更強大的 API