hasOwnProperty() 用來判斷一個屬性是不是物件「 own 」的,也就是直接定義在該物件上、而非沿原型鏈繼承而來。這個區別在遍歷物件時特別重要。
obj.hasOwnProperty(prop)
參數 prop 是要檢測的屬性名稱(字串)。回傳布林值。
所有繼承自 Object.prototype 的物件都能使用這個方法。與 in 運算子不同,hasOwnProperty() 會忽略原型鏈上繼承而來的屬性,只看物件本身。
o = new Object();
o.prop = 'exists';
function changeO() {
o.newprop = o.prop;
delete o.prop;
}
o.hasOwnProperty('prop'); // true
changeO();
o.hasOwnProperty('prop'); // false,屬性已被刪除
o = new Object();
o.prop = 'exists';
o.hasOwnProperty('prop'); // true
o.hasOwnProperty('toString'); // false,來自原型鏈
o.hasOwnProperty('hasOwnProperty'); // false,同樣來自原型鏈
這是最實用的場景。for...in 會把原型鏈上的可枚舉屬性也一起列出來,加上這個判斷就能只處理自己的屬性:
var buz = {
fog: 'stack'
};
for (var name in buz) {
if (buz.hasOwnProperty(name)) {
alert("this is fog (" + name + ") for sure. Value: " + buz[name]);
} else {
alert(name); // toString 或其他繼承而來的屬性
}
}
如果目標是取得「所有自有屬性名稱」,不論是否可枚舉,用 Object.getOwnPropertyNames() 會更直接。
若物件自己定義了名為 hasOwnProperty 的屬性,原型鏈上的原生方法就被遮住了,呼叫結果不再可靠:
var foo = {
hasOwnProperty: function() {
return false;
},
bar: 'Here be dragons'
};
foo.hasOwnProperty('bar'); // 永遠是 false
// 保險做法:直接借用原型上的方法
({}).hasOwnProperty.call(foo, 'bar'); // true
Object.prototype.hasOwnProperty.call(foo, 'bar'); // true
另一個相關的歷史地雷:在 IE 中,若物件名稱含有 hasOwnProperty 這個 key,某些舊引擎會出錯,因此 Object.prototype.hasOwnProperty.call() 這種寫法在函式庫中被廣泛採用。
ES2022 起有了語意更清楚的 Object.hasOwn(obj, prop),不受遮蔽問題影響,也更好讀。若環境允許,優先使用它:
Object.hasOwn(foo, 'bar'); // true