萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

JavaScript 判斷 JSON 對象是否包含某字段的三種方法

問題背景

接收後端返回的 JSON 數據時,需判斷某字段是否存在。直接用 obj.key !== undefined 存在缺陷:若字段存在但值為 undefined 會誤判為不存在。

三種標準方法對比

方法代碼優點缺點
1. in 操作符 "key" in obj 檢查原型鏈上是否存在,無論值為何(含 undefined)均返回 true 包含繼承屬性
2. hasOwnProperty obj.hasOwnProperty("key") 僅檢查對象自身屬性,忽略繼承屬性 需確保 obj 不為 null/undefined
3. 直接訪問 !== undefined obj["key"] !== undefined 簡潔 缺陷:值為 undefined 時誤判為不存在

代碼驗證

var obj = { key: undefined };

console.log(obj["key"] !== undefined);        // false ❌ (字段存在但值為 undefined)
console.log("key" in obj);                    // true  ✅
console.log(obj.hasOwnProperty("key"));       // true  ✅

// 判斷不存在
console.log(!("key" in obj));                 // false
console.log(!obj.hasOwnProperty("key"));      // false

// 注意運算符優先級!
console.log(!"key" in obj); // 誤寫!等價於 (false in obj) → false
// 正確寫法必須加括號
console.log(!("key" in obj)); // true 若不存在

實戰封裝工具函數

/**
 * 安全判斷對象是否擁有某屬性(自身屬性)
 * @param {Object} obj - 目標對象
 * @param {String} key - 屬性名
 * @returns {Boolean}
 */
function hasOwnProp(obj, key) {
    if (obj == null) return false; // null/undefined 保護
    return Object.prototype.hasOwnProperty.call(obj, key);
}

/**
 * 判斷屬性是否存在(含原型鏈)
 */
function hasProp(obj, key) {
    if (obj == null) return false;
    return key in obj;
}

// 使用
var data = { id: 1, name: undefined, getInfo: function(){} };
console.log(hasOwnProp(data, 'id'));      // true
console.log(hasOwnProp(data, 'name'));    // true (值為 undefined 但屬性存在)
console.log(hasOwnProp(data, 'age'));     // false
console.log(hasOwnProp(data, 'toString'));// false (繼承屬性)
console.log(hasProp(data, 'toString'));   // true (原型鏈上有)

TypeScript 類型守衛寫法

function hasKey(obj: T, key: PropertyKey): key is keyof T {
    return Object.prototype.hasOwnProperty.call(obj, key);
}

// 使用
interface User { id: number; name?: string; }
const user: User = { id: 1 };

if (hasKey(user, 'name')) {
    // TS 這裡知道 user.name 存在(可能為 undefined)
    console.log(user.name); // 類型收窄為 string | undefined
}

常見誤區

  1. 混淆「屬性存在」與「值不為 undefined」:obj.key 返回 undefined 可能是不存在,也可能是顯式賦值 undefined
  2. 忘記 null/undefined 保護:null.hasOwnProperty() 拋錯
  3. 使用 for...in 遍歷判斷:性能差且包含可枚舉繼承屬性
  4. ES6 Symbol 屬性:"key" in obj 和 hasOwnProperty 均支援 Symbol key

結語

判斷 JSON 字段存在性,首選 obj.hasOwnProperty("key")(僅自身屬性),次選 "key" in obj(含繼承)。堅決避免 obj.key !== undefined。封裝工具函數並加入空值保護,是項目級最佳實踐。

copyright © 萬盛學電腦網 all rights reserved