JS怎么获取对象属性个数:Object.keys().length用法详解

作者:代码拾荒

时间:2026-11-18

浏览:430

详细讲解在JavaScript中获取对象自身属性个数的核心方法Object.keys().length,剖析其执行机制、适用边界、原型链与不可枚举属性处理,以及空对象判定与性能考量。

文章目录
JavaScript 基础与进阶 阅读时间:约 6 分钟 核心 API:Object.keys()
JS怎么获取对象属性个数:Object.keys().length用法详解
缩略图:从对象映射到键名数组再读取长度的转换流程
在 JavaScript 中,普通 Object 原生并未提供类似数组的 length 属性。要获取一个普通对象自身拥有的属性个数,最常用、最标准的方法是调用内置静态方法 Object.keys(obj),先提取由对象所有自身可枚举属性名组成的数组,再读取该数组的 .length 属性。简写形式即为 Object.keys(obj).length。

一、为什么对象不能直接使用 .length?

初学 JavaScript 时,很多开发者容易把普通对象(Object)与数组(Array)混淆,尝试直接写 obj.length,结果却得到 undefined。

这种差异源于两者的底层设计定位:数组是一种具备连续索引结构的有序集合,引擎在内部自动维护着一个非负整数的 length 属性,随着元素的增删动态更新;而普通对象本质上是无序的键值对映射表(Hash Map),语言规范中并未给其设计专用的计数字段。

因此,必须借助辅助工具,将对象的键提取到一个有序结构中,再去计算其数量。

二、Object.keys().length 基础用法与分步示例

Object.keys() 是 ES5(ECMAScript 5.1)引入的内置标准方法。它接收一个目标对象作为参数,返回一个包含该对象所有自身可枚举属性名称的字符串数组。

基础使用范例

// 1. 定义一个常规用户信息对象
const userInfo = {
  id: 1001,
  name: "张三",
  department: "研发部",
  isActive: true
};

// 2. 调用 Object.keys() 获取键名数组
const keysArray = Object.keys(userInfo);
console.log("提取出的键名数组:", keysArray);

// 3. 读取数组长度得到属性个数
const propCount = keysArray.length;
console.log("对象自身属性个数:", propCount);

// 实际开发中通常连写
const total = Object.keys(userInfo).length;
console.log("链式调用结果:", total);
示例输出: 提取出的键名数组: [ 'id', 'name', 'department', 'isActive' ]
对象自身属性个数: 4
链式调用结果: 4
JS怎么获取对象属性个数:Object.keys().length用法详解
图 1:Object.keys().length 四步流转执行机制

如上图所示,当执行 Object.keys(userInfo).length 时,执行过程分为四个具体阶段:

  1. 输入目标对象:引擎读取内存中的目标对象实例;
  2. 底层过滤筛选:JavaScript 引擎依照语言规范,遍历对象自身并过滤掉不可枚举属性与 Symbol 属性;
  3. 实例化数组:将合格的字符串键名按规范顺序打包成一个全新的 Array 实例返回;
  4. 读取长度属性:访问新数组的 .length 属性,直接得到属性计数值。

三、Object.keys() 统计属性的范围与边界规则

虽然 Object.keys().length 是最通用的手段,但要写出健壮可靠的代码,必须明确它的“统计边界”。一个属性能够被 Object.keys() 统计到,必须同时满足两个硬性条件:

  • 必须是对象自身的属性(Own Property):原型链(Prototype Chain)上继承的任何属性都会被自动排除。
  • 必须是可枚举属性(Enumerable):属性描述符中的 enumerable 必须为 true。
JS怎么获取对象属性个数:Object.keys().length用法详解
图 2:JavaScript 对象属性分类与 Object.keys() 统计边界矩阵

代码验证:原型属性与不可枚举属性的过滤表现

// 1. 定义基础原型
const vehicle = { wheels: 4 };

// 2. 以 vehicle 为原型创建 car 对象
const car = Object.create(vehicle);
car.brand = "Tesla";
car.model = "Model 3";

// 3. 定义一个不可枚举属性(如内部序列号)
Object.defineProperty(car, "secretVin", {
  value: "VIN-987654321",
  enumerable: false
});

// 4. 定义一个 Symbol 键名属性
const tokenSym = Symbol("token");
car[tokenSym] = "secure-token-abc";

// 测试 Object.keys()
console.log("Object.keys 提取结果:", Object.keys(car));
console.log("Object.keys().length:", Object.keys(car).length);
示例输出: Object.keys 提取结果: [ 'brand', 'model' ]
Object.keys().length: 2

在这个例子中,car 对象实际关联着 5 个属性:

  • wheels:来自于原型链,被 Object.keys() 忽略;
  • secretVin:虽然属于 car 自身,但因 enumerable: false,被 Object.keys() 忽略;
  • [tokenSym]:属于 Symbol 键名,被 Object.keys() 忽略;
  • brand 与 model:自身可枚举字符串属性,成功被采集。因此最终结果为 2。

这也正是为什么 Object.keys() 优于传统 for...in 循环的原因:for...in 默认会向上遍历原型链,必须额外手动调用 Object.prototype.hasOwnProperty.call(obj, key) 进行防范,而 Object.keys() 天生保证只采集对象自身属性。

四、进阶场景:获取不同维度属性个数的技术选型

当面对更复杂的数据结构(例如使用 Object.defineProperty 封装的组件实例,或带有 Symbol 私有标识的实体)时,仅靠 Object.keys() 可能无法统计到完整字段。可以依据业务目标按需选用以下方案:

JS怎么获取对象属性个数:Object.keys().length用法详解
图 3:获取对象属性个数的技术选型决策路径

1. 统计包含不可枚举属性:Object.getOwnPropertyNames()

如果需要统计对象上定义的所有普通字符串键名(无论 enumerable 是否为 true),应改用 Object.getOwnPropertyNames(obj).length。

// 接上文 car 实例
const allStringKeys = Object.getOwnPropertyNames(car);
console.log("所有自身字符串属性:", allStringKeys);
console.log("属性个数:", allStringKeys.length);
示例输出: 所有自身字符串属性: [ 'brand', 'model', 'secretVin' ]
属性个数: 3

2. 统计包含 Symbol 属性:Reflect.ownKeys()

ES6 引入了 Reflect.ownKeys(obj),它等价于 Object.getOwnPropertyNames(target).concat(Object.getOwnPropertySymbols(target)),能够一次性拿到自身的所有键(含不可枚举及 Symbol)。

const fullKeys = Reflect.ownKeys(car);
console.log("Reflect.ownKeys 结果:", fullKeys);
console.log("全集属性总个数:", fullKeys.length);
示例输出: Reflect.ownKeys 结果: [ 'brand', 'model', 'secretVin', Symbol(token) ]
全集属性总个数: 4

五、实战注意事项与性能避坑指南

在真实业务开发中,将 Object.keys().length 应用到接口返回校验、状态同步或算法处理时,还需牢记以下四项细节:

JS怎么获取对象属性个数:Object.keys().length用法详解
图 4:Object.keys().length 最佳实践与核心注意事项

1. 防御 TypeError:null 与 undefined 的安全处理

在 ES6 规范下,向 Object.keys() 传入基本数据类型(如数字、字符串、布尔值)时,引擎会自动将其包装为对应的对象类型(装箱操作)。例如 Object.keys("cat") 会返回 ['0', '1', '2'],长度为 3。

注意:如果传入的值为 null 或 undefined,因为两者无法转为对象,会直接抛出严重的 TypeError: Cannot convert undefined or null to object 错误。

在处理异步请求或组件传参等不确定数据时,务必提供保底容错:

function getSafePropertyCount(data) {
  // 利用空值合并或逻辑或赋默认空对象,确保不抛异常
  return Object.keys(data ?? {}).length;
}

console.log(getSafePropertyCount(null));      // 0
console.log(getSafePropertyCount(undefined)); // 0
console.log(getSafePropertyCount({ a: 1 }));   // 1

2. 优雅判断是否为空对象

在 JavaScript 中,对象是引用类型,{} === {} 永远为 false。判断一个对象是否没有定义任何自身属性的最推荐方式即为判断其长度是否为 0:

const responseData = {};

// 标准判空推荐写法
const isEmpty = Object.keys(responseData).length === 0;

if (isEmpty) {
  console.log("当前对象为空对象");
}

相比于 JSON.stringify(obj) === '{}',这种方式不需要执行整个对象的字符串序列化,计算更快且语义清晰。

3. 内存与高频性能考量

Object.keys() 每调用一次,底层都会在堆内存中新分配一个包含了所有键名的临时数组。在普通前端业务逻辑或中后台表格处理中,这个开销微乎其微。

但在高频循环(例如每秒执行数十万次的实时图形计算或超大数据集处理)中,反复频繁生成庞大的中间数组可能触发垃圾回收(GC)开销。遇到这类极端性能场景时,可考虑在数据录入时独立维护一个计数字段,或采用原生提供 size 属性的 Map 结构。

六、核心要点总结

  • 核心写法:获取普通 JavaScript 对象的自身属性个数,首选且标准的方案是 Object.keys(obj).length。
  • 统计边界:只统计对象自身、可枚举且以字符串为键名的属性;原型属性、不可枚举属性及 Symbol 属性均不计入。
  • 特殊扩展:如需包含不可枚举属性,使用 Object.getOwnPropertyNames(obj).length;如需包含 Symbol 键,使用 Reflect.ownKeys(obj).length。
  • 严谨防御:避免对 null 或 undefined 直接求长度,使用 Object.keys(obj ?? {}).length 规避运行时崩溃。

实用工具推荐

电子包浆

绿化、压缩、噪点和虚拟水印,自由调节做旧程度。

使用 ›
图片压缩

选择画质和输出格式,预览压缩前后的大小。

使用 ›
相关文章