萬盛學電腦網

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

JavaScript 獲取物件屬性數量:Object.keys 與傳統 for...in 對比

獲取物件自有屬性個數是常見需求。本文對比傳統 for...in + hasOwnProperty 與現代 Object.keys、Object.getOwnPropertyNames、Reflect.ownKeys,分析適用場景與陷阱。

傳統寫法:for...in + hasOwnProperty

function objectSize(obj) {
  var count = 0;
  for (var key in obj) {
    if (obj.hasOwnProperty(key)) count++;
  }
  return count;
}

var obj = { dog: 'cat', cat: 'dog' };
console.log(objectSize(obj)); // 2

缺點:需手動過濾原型鏈屬性、語法冗長、效能一般。

現代標準:Object.keys(推薦)

function objectSize(obj) {
  return Object.keys(obj).length;
}
  • 僅回傳**自有可列舉**屬性鍵名陣列。
  • ES5 標準、全瀏覽器支援(IE9+)、引擎高度優化。
  • 忽略 Symbol 鍵、不可列舉屬性、繼承屬性。

進階:包含 Symbol 與不可列舉屬性

方法回傳內容含 Symbol含不可列舉含繼承
Object.keys字串鍵陣列❌❌❌
Object.getOwnPropertyNames字串鍵陣列❌✅❌
Object.getOwnPropertySymbolsSymbol 鍵陣列✅✅❌
Reflect.ownKeys所有鍵陣列(字串+Symbol)✅✅❌
const obj = {
  a: 1,
  get b() { return 2; },           // 不可列舉
  [Symbol('id')]: 3                // Symbol 鍵
};

Object.keys(obj).length;                 // 1 (只有 'a')
Object.getOwnPropertyNames(obj).length;  // 2 ('a', 'b')
Reflect.ownKeys(obj).length;             // 3 ('a', 'b', Symbol(id))

常見陷阱

  • null/undefined:Object.keys(null) 拋出 TypeError,需防禦:obj == null ? 0 : Object.keys(obj).length。
  • 原始值包裝:Object.keys('abc') 回傳 ['0','1','2'](字串索引),非預期行為。
  • DOM 節點:Object.keys(document.body) 回傳大量屬性,非業務屬性計數。

通用工具函數

/**
 * 獲取物件自有屬性數量(含 Symbol、不可列舉)
 * @param {Object} obj
 * @returns {number}
 */
function getOwnPropertyCount(obj) {
  if (obj == null) return 0;
  return Reflect.ownKeys(Object(obj)).length;
}

/**
 * 獲取物件自有可列舉字串屬性數量(最常用)
 * @param {Object} obj
 * @returns {number}
 */
function getOwnEnumerableCount(obj) {
  if (obj == null) return 0;
  return Object.keys(Object(obj)).length;
}

根據業務需求選擇合適 API:多數情況 Object.keys.length 即可;需完整掌握物件結構(如序列化、深拷貝)用 Reflect.ownKeys。

copyright © 萬盛學電腦網 all rights reserved