屬性描述符是 ECMAScript 5 新增的重要概念,主要用來更精細地控制物件屬性的行為。透過屬性描述符,開發者可以決定屬性是否可寫、是否可枚舉、是否可刪除,甚至可以用 getter 與 setter 自訂讀寫行為。
要使用屬性描述符,最常見的入口是 Object.defineProperty()。這個方法可以用來定義新屬性,或修改既有屬性:
Object.defineProperty(obj, prop, descriptor)
例如:
var obj = {};
Object.defineProperty(obj, 'attr', {
value: 1
});
這段程式碼相當於:
var obj = {};
obj.attr = 1;
看起來似乎更麻煩,但真正的價值在於第三個參數 descriptor,也就是屬性描述符。
資料描述符主要用來控制一般資料屬性的行為,常見欄位包括:
value:屬性的值。writable:是否可寫入。enumerable:是否可被枚舉。configurable:是否可刪除或重新定義。若希望屬性變成唯讀,可以將 writable 設為 false:
var obj = {};
Object.defineProperty(obj, 'attr', {
value: 1,
writable: false
});
console.log(obj.attr); // 1
obj.attr = 2;
console.log(obj.attr); // 1
在非嚴格模式下,這種寫入失敗通常不會拋錯,而是靜默失敗。若希望錯誤明確顯現,可以搭配嚴格模式:
'use strict';
var obj = {};
Object.defineProperty(obj, 'attr', {
value: 1,
writable: false
});
obj.attr = 2; // 拋出錯誤
一般透過賦值建立的屬性,通常可以在 for...in 中被枚舉:
var obj = {};
obj.attr = 1;
for (var key in obj) {
console.log(key);
}
但若將 enumerable 設為 false,屬性就會被隱藏起來:
var obj = {};
Object.defineProperty(obj, 'attr', {
value: 1,
enumerable: false
});
for (var key in obj) {
console.log(key);
}
這時,attr 不會出現在 for...in 的結果中。
屬性描述符本身是否可以再次修改,取決於 configurable。若此值為 false,屬性描述符就不能再被更改,屬性也不能被刪除。
var obj = {};
Object.defineProperty(obj, 'attr', {
value: 1,
writable: false,
configurable: true
});
Object.defineProperty(obj, 'attr', {
writable: true
});
obj.attr = 2;
在這個例子中,因為原本設定 configurable: true,所以後續可以重新定義 writable。
存取描述符類似物件導向中的 getter 與 setter,可以用來攔截屬性的讀取與寫入:
var obj = {};
Object.defineProperty(obj, 'attr', {
set: function (val) {
this._attr = Math.max(0, val);
},
get: function () {
return this._attr;
}
});
obj.attr = -1;
console.log(obj.attr); // 0
在這個例子中,對 attr 的讀寫實際上被導向 _attr,并且在 setter 中限制了最小值。
若要取得既有屬性的描述符,可以使用 Object.getOwnPropertyDescriptor():
var obj = {};
Object.defineProperty(obj, 'attr', {
value: 1,
writable: false,
configurable: true
});
var desc = Object.getOwnPropertyDescriptor(obj, 'attr');
console.dir(desc);
除了針對單一屬性進行控制,ES5 也提供了直接操作整個物件的方法。
讓物件無法再新增屬性:
var obj = {};
obj.attr = 1;
Object.preventExtensions(obj);
obj.attr2 = 2; // 失敗
讓物件無法新增或刪除屬性,但既有屬性的值仍可能可修改:
var obj = {};
obj.attr = 1;
Object.seal(obj);
obj.attr = 1.5;
delete obj.attr; // 失敗
讓物件完全無法被修改,包含無法新增、刪除或改寫屬性:
var obj = {};
obj.attr = 1;
Object.freeze(obj);
obj.attr = 1.5; // 失敗
obj.attr2 = 2; // 失敗
若要檢查物件是否被擴展、封印或凍結,可以分別使用:
Object.isExtensible(obj)Object.isSealed(obj)Object.isFrozen(obj)屬性描述符讓 JavaScript 物件擁有更細緻的控制能力,可以用來建立唯讀屬性、隱藏屬性、實作 getter/setter,以及凍結或封印物件。這些機制在建立函式庫、框架與需要嚴謹資料控制的场景中非常有用。不過在實際專案中,仍應搭配瀏覽器支援情況與團隊共識審慎使用。