JS怎么遍历对象的所有键名:Object.keys与for...in的差异

作者:半夏

时间:2026-11-20

浏览:230

深入对比JavaScript中遍历对象键名的常用方式Object.keys与for...in,全面解析自身属性与原型链、可枚举属性判定、排序规范与工程选型最佳实践。

文章目录
遍历 JavaScript 对象的键名最常用的两种方式是 Object.keys() 与 for...in 循环。它们的核心差异在于遍历范围的边界定义:Object.keys() 仅提取对象自身(Own Property)并且处于可枚举状态的字符串键名,返回一个数组;而 for...in 则会沿着原型链一路向上回溯,遍历对象自身及其所有继承而来的可枚举字符串键名。在现代前端与 Node.js 业务开发中,纯数据对象应当首选 Object.keys();如果业务确实需要读取原型继承属性,使用 for...in 时必须配合 Object.hasOwn() 进行防御性过滤。
JS怎么遍历对象的所有键名:Object.keys与for...in的差异
图 0:Object.keys 与 for...in 的核心访问边界对比示意图

一、核心结论与机制速查

为了让开发者在排查问题或编写业务逻辑时快速做出判断,下表整理了 Object.keys() 与 for...in 在各个关键维度的直接对比:

比较维度 Object.keys(obj) for (const key in obj)
属性归属范围 仅对象自身拥有的属性(Own Properties) 对象自身及其整条原型链上的继承属性
返回值形式 字符串数组 Array<string> 无返回值,按循环语句逐步迭代变量
可枚举性约束 仅提取 enumerable: true 的属性 仅访问 enumerable: true 的属性
Symbol 键支持 自动忽略(不包含 Symbol 属性) 自动忽略(不包含 Symbol 属性)
原型链污染防御 天然隔离原型属性,无需额外防御代码 容易被原型扩展污染,必须手动过滤
函数式链式调用 支持直接调用 .map()、.filter()、.forEach() 不支持,需在循环体内部编写控制逻辑

二、Object.keys() 的工作机制与使用规范

Object.keys() 是 ECMAScript 5 引入的静态方法。它接收一个目标对象作为参数,返回一个由该对象自身所有可枚举属性名称组成的数组。

1. 基础用法与代码示例

在处理服务端返回的 JSON 数据或普通字面量对象时,Object.keys() 是最直接的提取方式:

// 基础数据对象遍历
const userProfile = {
  id: 1024,
  username: "chen_developer",
  role: "admin"
};

const keys = Object.keys(userProfile);
console.log(keys); 
// 示例输出: ["id", "username", "role"]

// 结合数组高阶方法进行值映射与遍历
keys.forEach(key => {
  console.log(`${key}: ${userProfile[key]}`);
});

2. 不可枚举属性与非对象参数处理

当属性通过 Object.defineProperty() 定义且未显式指定 enumerable: true 时,该属性默认为不可枚举,Object.keys() 会自动忽略它:

const device = { brand: "Apple" };

// 定义一个不可枚举属性
Object.defineProperty(device, "serialNumber", {
  value: "SN-998822",
  enumerable: false
});

console.log(Object.keys(device)); 
// 示例输出: ["brand"] (serialNumber 被自动过滤)

此外,在 ES2015(ES6)标准中,如果向 Object.keys() 传入非对象的基本类型值(如数字、布尔值或字符串),引擎会首先将其强制装箱为包装对象。例如传入字符串 "JS",会返回索引键名 ["0", "1"];若传入 null 或 undefined,则会抛出 TypeError 异常。

JS怎么遍历对象的所有键名:Object.keys与for...in的差异
图 1:Object.keys() 内部执行流水线与属性过滤流程

三、for...in 的查找机制与原型链继承陷阱

for...in 循环是 JavaScript 从诞生初期就存在的语法结构。它的初衷是遍历对象的所有可枚举属性,但其设计包含了对原型链([[Prototype]])的自动向上递归查找。

1. 原型链遍历与污染示例

当一个对象的原型链上存在自定义属性或被第三方库扩展了属性时,for...in 会将这些继承属性一并枚举出来:

// 定义父级原型对象
const protoParent = {
  inheritedTag: "v2-release"
};

// 以 protoParent 为原型创建子对象
const childItem = Object.create(protoParent);
childItem.title = "深入理解JS引擎";
childItem.pageCount = 380;

// 使用 for...in 遍历
for (const prop in childItem) {
  console.log(prop);
}
// 示例输出:
// "title"
// "pageCount"
// "inheritedTag"  <-- 注意:原型上的属性被直接输出了!
注意事项:为什么 Object.prototype 上的自带方法不会被打印?
读者可能会疑惑:既然 for...in 遍历整条原型链,为什么顶层 Object.prototype 上的 toString、hasOwnProperty、valueOf 等方法没有出现在循环中?这是因为 JavaScript 引擎在底层将这些内置原生属性的描述符默认配置为了 enumerable: false。但如果某些旧脚本或第三方模块执行了类似于 Object.prototype.customUtil = function() {} 的修改,该属性默认是可枚举的,所有对象的 for...in 循环都会受到破坏。

2. 防御性过滤的最佳实践

如果因为特定场景(例如需要遍历遗留类库的继承属性)必须使用 for...in,必须在循环体内部通过属性检查过滤掉原型链上的属性。

在过去的 ES5/ES6 时代,常用写法是 obj.hasOwnProperty(prop)。但在现代工程中,推荐使用 ES2022 引入的静态方法 Object.hasOwn(obj, prop):

for (const key in childItem) {
  // 现代推荐:Object.hasOwn 更加安全,即使对象使用 Object.create(null) 创建也不会报错
  if (Object.hasOwn(childItem, key)) {
    console.log(`自身属性: ${key} = ${childItem[key]}`);
  }
}
// 示例输出:
// 自身属性: title = 深入理解JS引擎
// 自身属性: pageCount = 380
JS怎么遍历对象的所有键名:Object.keys与for...in的差异
图 2:原型链分层拓扑与 for...in 跨层向上回溯路径

四、属性遍历顺序与特殊键名处理

很多开发者容易忽略对象键名的排序规律。在 ECMAScript 规范中,对象内部属性遍历的顺序有着明确且严格的定义:

  1. 整数索引键:所有非负整数索引(如 0, 1, 2 等),无论在代码中以何种先后顺序写入,一律按数值大小升序排序。
  2. 普通字符串键:非整数类型的字符串键名,严格按照它们被创建或写入对象的先后时间顺序排列。
  3. Symbol 键:若存在 Symbol 属性,按创建时间顺序排列(但在 Object.keys 和 for...in 中会被直接排除)。
const mixedObj = {
  "b": "second string",
  "2": "integer 2",
  "a": "first string",
  "0": "integer 0"
};

console.log(Object.keys(mixedObj));
// 示例输出: ["0", "2", "b", "a"]
// 规则解析: 整数键 "0", "2" 升序排在最前;普通字符串 "b", "a" 紧随其后并保持插入序

需要特别注意:Object.keys() 严格执行上述 ES 规范排序;而 for...in 在遍历自身属性时通常遵循该顺序,但进入原型链后,不同 JavaScript 引擎在跨原型的属性交错枚举实现细节上可能存在微妙差异。因此,依赖 for...in 的枚举顺序存在潜在的不确定性。

五、工程实践中的选型决策

在实际项目编码中,如何根据业务需求做出明确的技术选型?

  • 场景 A:API 响应、配置参数、实体状态等数据对象
    首选方案:Object.keys(obj)。绝大多数现代数据传输对象都不涉及原型属性继承。使用 Object.keys(obj) 能够完全阻断任何原型链带来的意外变量,代码简洁,且能直接利用数组的方法链完成变换。
  • 场景 B:继承结构深、必须检查原型属性的面向对象模块
    使用方案:for...in 循环。如果业务架构确实依赖原型继承共享字段,并且需要动态感知继承属性,可以使用 for...in,但务必在循环体首行加上 Object.hasOwn() 判定,明确区分是自身字段还是继承字段。
  • 场景 C:海量属性且需要提前 break 中断的循环
    使用方案:for...in 或普通 for 循环配合 Object.keys。for...in 允许在满足条件时使用 break 提前跳出,而 Object.keys() 必须先生成整份键名数组。如果对象包含几十万个属性且仅需查找命中首个匹配项,直接生成巨大数组会产生瞬时内存开销。
JS怎么遍历对象的所有键名:Object.keys与for...in的差异
图 3:JavaScript 属性遍历方法工程选型决策流

六、拓展方案:如何获取真正的“全部”键名?

如果开发者的目标是实现深拷贝工具库(如类似 Lodash 的 cloneDeep)、序列化器或底层框架反射,仅依靠 Object.keys() 和 for...in 是无法拿到对象全部键名的,因为它们都会过滤掉 Symbol 键以及不可枚举属性。

此时应当根据需求选用以下原生替代方法:

const idSymbol = Symbol("internal_id");
const record = {
  visibleData: "公开内容",
  [idSymbol]: 98765
};

Object.defineProperty(record, "systemFlag", {
  value: "LOCKED",
  enumerable: false
});

// 1. 仅获取自身可枚举字符串属性
console.log(Object.keys(record));
// 示例输出: ["visibleData"]

// 2. 获取自身所有字符串属性(包含不可枚举)
console.log(Object.getOwnPropertyNames(record));
// 示例输出: ["visibleData", "systemFlag"]

// 3. 仅获取自身所有 Symbol 属性
console.log(Object.getOwnPropertySymbols(record));
// 示例输出: [Symbol(internal_id)]

// 4. 获取自身全部键名(包含字符串、不可枚举以及 Symbol)
console.log(Reflect.ownKeys(record));
// 示例输出: ["visibleData", "systemFlag", Symbol(internal_id)]

七、知识全景与总结矩阵

遍历 JavaScript 对象的键名看似简单,却直接连接着原型链继承、属性描述符(Property Descriptor)和 ES6+ 元编程规范。掌握 Object.keys() 与 for...in 的区别,是编写稳健、安全前端与服务端 JavaScript 代码的基础基本功。

JS怎么遍历对象的所有键名:Object.keys与for...in的差异
图 4:JavaScript 对象键名遍历体系特性全景矩阵
日常编码准则:
  1. 将 Object.keys() 作为日常处理普通对象与字典映射的默认首选。
  2. 尽量避免裸写 for...in;若使用,必须结合 Object.hasOwn(obj, key) 保障边界安全。
  3. 在编写涉及底多元编程或通用克隆/序列化库时,使用 Reflect.ownKeys() 获取最完整对象属性。

实用工具推荐

电子包浆

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

使用 ›
图片压缩

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

使用 ›
相关文章