propertyIsEnumerable() 用來檢查某個屬性是否屬於指定物件、且能透過 for...in 遍歷出來。是的話回傳 true,否則回傳 false。
要回傳 true,必須同時滿足兩點:
1. 該屬性屬於物件「實例本身」,而不是掛在原型鏈上。
2. 該屬性是可枚舉的,也就是自前綴自訂的屬性,能被 for...in 列出來。
這兩點只要有一項不成立,結果就是 false。
/*
* propertyIsEnumerable() 用來檢測屬性是否屬於某個物件,
* 並且是可枚舉的(自訂屬性、能透過 for...in 遍歷出來)。
*/
function MyObject() {
this.name = "我是實例的屬性";
}
var obj = new MyObject();
alert(obj.propertyIsEnumerable("name")); // true ← 實例自身的可枚舉屬性
MyObject.prototype.say = "我是原型的屬性";
alert(obj.propertyIsEnumerable("say")); // false ← 掛在原型上,非實例自身
for (var i in obj) {
alert(i); // 會列出 name 與 say(原型上的可枚舉屬性也會被列出)
}
最後這段 for...in 的結果值得留意:它會把 name 和 say 都印出來。這正好說明了 propertyIsEnumerable() 與 for...in 的判斷範圍不同——前者只認「自己的」屬性,後者會沿著原型鏈一路往上找。兩者搭配使用,才能精確分辨一個屬性到底是實例資料還是原型方法。
obj.hasOwnProperty('name'); // 是否為自身屬性(不論是否可枚舉)
obj.propertyIsEnumerable('name'); // 是否為自身「且」可枚舉
'name' in obj; // 是否存在(含原型鏈)
Object.keys(obj); // 自身所有可枚舉屬性的名稱陣列
實務上,如果想取得「這個物件自己的可枚舉屬性清單」,Object.keys() 通常比 propertyIsEnumerable() 更好用;後者比較適合單點檢查的場合,例如判斷某個選用的設定欄位是否真的被使用者明確設定過。另外提醒,以 Object.create(null) 建立的物件沒有繼承 Object 原型,因此呼叫 propertyIsEnumerable() 會拋出錯誤,這種情況要改用 Object.prototype.propertyIsEnumerable.call(obj, key)。