hasOwnProperty() 是每個 JavaScript 物件都有的方法,用來判斷某個屬性是否屬於物件「本身」。它看起來簡單,但背後牽涉到原型鏈、可枚舉性與屬性遮蔽等觀念,值得完整梳理一次。
object.hasOwnProperty(proName)
object(必填):物件實例。proName(必填):屬性名稱的字串。回傳布林值:若物件自身擁有該屬性則回傳 true,否則 false。
關鍵限制:它不會檢查原型鏈。屬性必須是物件自身的成員,繼承而來的屬性一律回傳 false。
var s = new String("JScript");
s.hasOwnProperty("split"); // false —— split 在原型上
String.prototype.hasOwnProperty("split"); // true —— 原型自己擁有它
所有 String 物件共用同一個 split 方法,它定義在 String.prototype 上。所以雖然 s.split(" ") 可以呼叫,但 s.hasOwnProperty("split") 是 false——因為 s 本身並沒有這個屬性,只是透過原型鏈「找得到」。
// 示例一:不能檢測原型鏈上的屬性
var bStr = "Test String".hasOwnProperty("split"); // false
// 但 "Test String".split(" ") 依然可以成功呼叫
// 示例二:直接問原型本身
var bStr1 = String.prototype.hasOwnProperty("split"); // true
// 示例三:物件字面值定義的方法
var bObj = ({ fnTest: function () {} }).hasOwnProperty("fnTest"); // true
三個例子合起來說明同一件事:hasOwnProperty 問的是「你是不是自己長出來的」,不是「你能不能找到」。
Object.prototype.bar = 1;
var foo = { goo: undefined };
foo.bar; // 1 —— 屬性讀取會走原型鏈
'bar' in foo; // true —— in 也走原型鏈
foo.hasOwnProperty('bar'); // false —— 只看自身
foo.hasOwnProperty('goo'); // true —— 自身有,即使值是 undefined
這段程式示範了一個容易誤解的要點:屬性存在但值為 undefined 時,hasOwnProperty 仍回傳 true。 因此無法用「值是否為 undefined」來判斷屬性存不存在,hasOwnProperty 是唯一可靠的途徑。
JavaScript 沒有把 hasOwnProperty 當成保留字。若物件剛好定義了同名屬性,直接呼叫就會得到錯誤結果:
var foo = {
hasOwnProperty: function () { return false; },
bar: 'Here be dragons'
};
foo.hasOwnProperty('bar'); // false(被遮蔽了)
{}.hasOwnProperty.call(foo, 'bar'); // true(借用原型上的原方法)
更進一步的情況:用 Object.create(null) 建立的物件完全沒有原型,連 hasOwnProperty 都不存在:
var bare = Object.create(null);
bare.x = 1;
bare.hasOwnProperty('x'); // TypeError: bare.hasOwnProperty is not a function
Object.prototype.hasOwnProperty.call(bare, 'x'); // true,這樣才能用
因此建議一律寫成借用形式,或直接用 ES2022 的 Object.hasOwn():
Object.hasOwn(foo, 'bar'); // true,最簡潔且不受遮蔽影響
要真正搞懂 hasOwnProperty,需要理解它繼承自 Object.prototype。ECMAScript 中的所有物件都由此繼承而來,所以它的屬性與方法出現在每個物件上。
constructor —— 指向建立該物件的函數(一個引用/指標)。prototype —— 對該物件原型的引用,所有實例共用。hasOwnProperty(property) —— 判斷物件自身是否有該屬性,需用字串指定名稱,例如 o.hasOwnProperty("name")。isPrototypeOf(object) —— 判斷該物件是否為另一個物件的原型。propertyIsEnumerable(property) —— 判斷給定的自身屬性是否能以 for...in 枚舉。toString() —— 回傳物件的字串表示。ECMA-262 未定義 Object 上的具體值,因此各實作不同;自訂類別時常覆寫它。valueOf() —— 回傳最適合該物件的原始值。許多物件的結果與 toString() 相同,但 Date 回傳的是時間戳數字。Object.hasOwn(obj, key)(ES2022)或 Object.prototype.hasOwnProperty.call(obj, key)。Object.keys()/Object.entries(),它們天生只回傳自身且可枚舉的屬性,不必額外過濾。Object.getOwnPropertyNames(obj);若也要 Symbol,用 Reflect.ownKeys(obj)。for...in 遍歷陣列:它回傳的是索引字串而非元素,且會走原型鏈。陣列請用 for...of、forEach 或 map。理解 hasOwnProperty 的價值不只是會用這個方法,而是藉此理解 JavaScript 的原型鏈模型——屬性查找如何逐層向上、枚舉性如何影響行為、以及為什麼擴充原生原型是一個危險的習慣。