用 for...in 遍歷物件時,輸出結果突然多了一些沒寫過的屬性——這是幾乎每個 JavaScript 開發者都會遇到的一次困惑。原因在於 for...in 會連原型鏈上的屬性一起遍歷,而 hasOwnProperty 就是那把過濾的篩子。
// 擴充 Object.prototype
Object.prototype.bar = 1;
var foo = { moo: 2 };
for (var i in foo) {
console.log(i); // 輸出 bar 和 moo
}
我們只定義了 moo,卻印出兩個。因為 for...in 遍歷的是「物件及其原型鏈上所有可枚舉的屬性」,而我們剛剛在全域原型上加了 bar。
兩者都會檢查原型鏈,但有個關鍵不同:
for...in —— 遍歷原型鏈,但跳過不可枚舉的屬性(例如陣列的 length)。in 運算子 —— 檢查原型鏈,包含不可枚舉的屬性。"length" in [] 回傳 true。
for (var i in foo) {
if (foo.hasOwnProperty(i)) {
console.log(i); // 只輸出 moo
}
}
hasOwnProperty 只回報「物件自身的屬性」,完全不看原型鏈,這正是我們要的行為。
Object.prototype.bar = 1;
var foo = { goo: undefined };
foo.bar; // 1(來自原型)
'bar' in foo; // true(原型上有)
foo.hasOwnProperty('bar'); // false(自己沒有)
foo.hasOwnProperty('goo'); // true(自己有,值雖為 undefined)
最後一行是重點:hasOwnProperty 判斷的是「屬性是否存在」,而不是「值是否有定義」。屬性存在但值為 undefined 時,它仍回傳 true。這使得它成為唯一可靠的「自身屬性檢測」方法。
Prototype.js 這類早期框架大量擴充 JavaScript 原生物件(例如為 Array.prototype 加上 each、map)。框架一旦引入,任何沒有加 hasOwnProperty 過濾的 for...in 迴圈,輸出結果幾乎都不會是你預期的。這是當年無數 bug 的來源,也是 TC39 後來制定 Array.prototype 方法時必須用「不可枚舉」定義的原因之一。
JavaScript 並沒有把 hasOwnProperty 保留為關鍵字。如果某個物件剛好有同名的屬性,直接呼叫就會出錯:
var foo = {
hasOwnProperty: function () { return false; },
bar: 'Here be dragons'
};
foo.hasOwnProperty('bar'); // 永遠是 false
{}.hasOwnProperty.call(foo, 'bar'); // true —— 借用 Object 原型上的方法
更嚴謹的寫法:
Object.prototype.hasOwnProperty.call(obj, key); // 或 Object.hasOwn(obj, key); // ES2022 起,最推薦
另一個極端情況:用 Object.create(null) 建立的物件沒有原型,因此連 hasOwnProperty 都沒有,此時只能用上面兩種借用方式。
如果目的只是遍歷自身屬性,ES6 之後有更直白的 API,不必再手動過濾:
Object.keys(foo).forEach(function (key) {
console.log(key, foo[key]);
});
Object.entries(foo); // [[key, value], ...]
Object.values(foo); // [value, ...]
這三個方法只回傳自身且可枚舉的屬性,天生就没有原型鏈問題:
Object.prototype.bar = 1;
Object.keys({ moo: 2 }); // ["moo"],不含 bar
若要包含不可枚舉的自身屬性(例如自行用 Object.defineProperty 定義且 enumerable:false 的欄位),則用 Object.getOwnPropertyNames(obj),或連 Symbol 一起拿的 Reflect.ownKeys(obj)。
for...in 因為要遍歷整條原型鏈,在多重繼承或深層原型結構下明顯較慢。加上 hasOwnProperty 判斷只是減少錯誤輸出,並不能免除遍歷成本。單純遍歷自己的屬性時,Object.keys() 或 Object.entries() 都更快。
如果要在舊環境寫 for...in,養成加上 hasOwnProperty 判斷的習慣——你無法保證執行的環境沒有被其他程式碼擴充過。而在現代環境中,直接用 Object.keys/entries/values,或用 ES2022 的 Object.hasOwn(),都能更清楚地表達意圖並避免這一整類問題。