JS遍历对象属性的5种常用方法详解

作者:闭包旅人时间:2026-11-19 09:04:17浏览:404

全面解析JavaScript中遍历对象属性的5种常用方法:for...in、Object.keys、Object.getOwnPropertyNames、Object.getOwnPropertySymbols与Reflect.ownKeys。从原型链、可枚举性及Symbol键三大维度深入剖析执行原理、规范遍历顺序、避坑指南与选型决策。

JavaScript 深度指南
JS遍历对象属性的5种常用方法详解
图 0:JavaScript 对象属性遍历核心知识全景图
在 JavaScript 中,遍历对象属性看似是一项简单的基础操作,但由于对象属性存在所属权(自身属性与原型链继承属性)、可枚举性(enumerable 标志位)以及键类型(字符串与 Symbol)三大维度的差异,不同 API 的过滤规则截然不同。本文将详细讲解日常开发与底层架构中最常用的 5 种属性遍历方法,通过底层机制图解、完整代码演示与控制台真实示例,让读者彻底厘清它们的作用边界,掌握精确高效的选型方案。

一、理解对象属性的三个关键维度

要准确掌握不同遍历方法的结果差异,首先必须搞清楚 JavaScript 引擎如何定义和区分一个对象的属性。每个属性在底层都对应着属性描述符(Property Descriptor),并在对象结构中处于不同的层级:

  • 所有权维度(Own vs Prototype):属性是直接定义在对象实例自身上(Own Property),还是沿着隐式原型链 [[Prototype]] 继承自父级构造函数或 Object.prototype。
  • 可枚举性维度(Enumerable):属性描述符中的 enumerable 布尔值。通过普通字面量声明的属性默认为 true,而通过 Object.defineProperty() 声明且未显式指定时默认为 false。很多原生对象方法(如 toString)就是因为 enumerable: false 才不会出现在常规循环中。
  • 键名类型维度(String vs Symbol):ES6 引入了 Symbol 数据类型作为属性键。Symbol 键具有天然的防冲突和隐蔽性,绝大多数传统基于字符串的遍历接口都会直接将其略过。
JS遍历对象属性的5种常用方法详解
图 1:JavaScript 对象属性分类与三大维度分布全景

如上图所示,当遍历方法执行时,它会按照自身的过滤规则对这四个象限进行筛选。只有搞清了这三个维度的交集,后续面对不同 API 时才不会产生“属性为什么没有被打印出来”或“为什么突然多出了意外字段”的困惑。

二、5 种常用遍历方法逐一详解

在日常编码和框架开发中,最核心的 5 种遍历与提取属性名的方法分别是:for...in 循环、Object.keys()、Object.getOwnPropertyNames()、Object.getOwnPropertySymbols() 以及 Reflect.ownKeys()。下面我们配合统一的示例对象,逐一分析它们的具体行为与关键细节。

为了直观展现各方法的筛选差异,我们构造一个具有自身可枚举、自身不可枚举、Symbol 键以及原型链继承属性的复合对象作为基准环境:

// 准备基准测试对象
const parent = { protoProp: '来自原型的属性' };
const symKey = Symbol('metaKey');

// 创建继承 parent 的实例对象
const user = Object.create(parent);

// 1. 添加常规自身可枚举属性
user.id = 101;
user.name = 'Alice';

// 2. 添加自身不可枚举属性
Object.defineProperty(user, 'secretToken', {
  value: 'xyz-9988',
  enumerable: false,
  writable: true,
  configurable: true
});

// 3. 添加 Symbol 属性
user[symKey] = '内部元数据';

1. for...in 循环:遍历自身及原型链上的可枚举属性

for...in 是 JavaScript 诞生之初就存在的传统循环语句。它的核心特征是:会沿着原型链向上爬升,遍历对象自身及其所有原型对象上所有的可枚举属性(仅限字符串键),不会遍历不可枚举属性与 Symbol 属性。

// 示例代码:使用 for...in 遍历
console.log('--- for...in 遍历 ---');
for (const key in user) {
  console.log(`键名: ${key}, 值: ${user[key]}`);
}
示例输出 (Console Output)
键名: id, 值: 101
键名: name, 值: Alice
键名: protoProp, 值: 来自原型的属性
⚠️ 关键陷阱与防御规范

由于 for...in 会遍历原型链,如果第三方库或老旧代码在 Object.prototype 上扩展了自定义方法,这些方法会直接被循环吐出,造成极其严重的业务逻辑错误或属性污染。

若必须使用 for...in,必须配合 ES2022 推荐的 Object.hasOwn(obj, key)(或老版 Object.prototype.hasOwnProperty.call(obj, key))进行自身属性判定过滤:

for (const key in user) {
  if (Object.hasOwn(user, key)) {
    console.log('自身属性:', key);
  }
}

2. Object.keys():获取自身可枚举的字符串键数组

Object.keys() 是 ES5 引入的静态方法。与 for...in 最根本的区别在于:它只提取对象自身(Own)的可枚举字符串属性,绝对不上溯原型链,同时忽略 Symbol 属性。它返回一个包含属性名字符串的纯数组。

// 示例代码:使用 Object.keys()
const keys = Object.keys(user);
console.log('Object.keys 结果:', keys);

// 配合 Array 原型方法遍历
keys.forEach(key => {
  console.log(`属性名: ${key}, 属性值: ${user[key]}`);
});
示例输出 (Console Output)
Object.keys 结果: [ "id", "name" ]
属性名: id, 属性值: 101
属性名: name, 属性值: Alice

适用场景:绝大多数日常业务(如表单校验、接口 JSON 数据解析、对象键值转换)。在结合 Object.values() 与 Object.entries() 时,构成了现代 JavaScript 处理对象最常用、最安全的工具组合。

3. Object.getOwnPropertyNames():获取自身全部字符串键(含不可枚举)

Object.getOwnPropertyNames() 返回一个数组,包含对象自身的所有字符串键,无论其 enumerable 是 true 还是 false,但不包含原型链属性与 Symbol 属性。

// 示例代码:使用 Object.getOwnPropertyNames()
const allStringKeys = Object.getOwnPropertyNames(user);
console.log('getOwnPropertyNames 结果:', allStringKeys);
示例输出 (Console Output)
getOwnPropertyNames 结果: [ "id", "name", "secretToken" ]

注意事项与典型场景:

  • Notice不可枚举的 secretToken 被成功捕获,而原型链上的 protoProp 与 Symbol 依然被排除在外。
  • 审查类与内置对象原型:ES6 class 中定义的方法默认是不可枚举的,使用 Object.keys(MyClass.prototype) 会返回空数组,此时必须使用 Object.getOwnPropertyNames(MyClass.prototype) 才能完整获取类的方法列表。

4. Object.getOwnPropertySymbols():专门提取自身的 Symbol 键

由于 Symbol 类型的键具有独立的设计初衷,上述三种方法都会完全略过它。ES6 提供了专属的 Object.getOwnPropertySymbols() 方法,专门用来返回对象自身定义的所有 Symbol 属性键构成的数组(包含可枚举和不可枚举的 Symbol)。

// 示例代码:使用 Object.getOwnPropertySymbols()
const symbolKeys = Object.getOwnPropertySymbols(user);
console.log('getOwnPropertySymbols 结果:', symbolKeys);
console.log('读取对应值:', user[symbolKeys[0]]);
示例输出 (Console Output)
getOwnPropertySymbols 结果: [ Symbol(metaKey) ]
读取对应值: 内部元数据

典型场景:在构建插件架构、私有状态元数据管理或实现自定义协议(如定义 Symbol.iterator)时,用于读取和反射对象上的符号标记。

5. Reflect.ownKeys():全量获取自身所有属性键(最全自身集合)

Reflect.ownKeys() 是 ES6 规范中能力最全面的自身属性获取方法。它直接对应 ECMAScript 规范内部的 [[OwnPropertyKeys]] 操作。它返回一个包含对象自身所有键的数组,涵盖可枚举与不可枚举属性、常规字符串键与 Symbol 键,相当于 Object.getOwnPropertyNames() 与 Object.getOwnPropertySymbols() 结果的完整合并。

// 示例代码:使用 Reflect.ownKeys()
const fullKeys = Reflect.ownKeys(user);
console.log('Reflect.ownKeys 结果:', fullKeys);
示例输出 (Console Output)
Reflect.ownKeys 结果: [ "id", "name", "secretToken", Symbol(metaKey) ]

为什么是全量深拷贝首选?在实现真正的无损深克隆(Deep Clone)或编写 Proxy 拦截器(ownKeys trap)时,只有 Reflect.ownKeys() 能够保证不漏掉任何一个属性,确保不可枚举配置和 Symbol 键完好无损地传递给目标对象。

JS遍历对象属性的5种常用方法详解
图 2:for...in 原型链攀爬与 Object/Reflect 自身遍历机制底层对比

三、属性遍历顺序规范(ES6+ 确定性排序)

在早期 JavaScript 规范中,对象属性的遍历顺序未作强制约束,导致不同浏览器的表现曾存在细微差异。自 ES6 起,ECMAScript 规范对内部方法 [[OwnPropertyKeys]] 确立了严格、统一的排序规则。所有返回自身键数组的方法(Object.keys、Object.getOwnPropertyNames、Reflect.ownKeys)均遵循这一排序逻辑:

  1. 非负整数索引键:所有可以被转换为 32 位无符号整数的键(如 "0", "1", "10" 等),无论定义先后,一律按照数值升序排序。
  2. 常规字符串键:其余所有非整数数字及普通字符串类型的键,严格按照其被写入对象的先后时间顺序排序。
  3. Symbol 键:所有 Symbol 类型的键排在字符串之后,同样严格按照创建/挂载到对象的先后时间顺序排序。
// 验证属性遍历顺序
const mixedObj = {};
mixedObj[Symbol('s1')] = 'symbol1';
mixedObj['z'] = 'lastString';
mixedObj[100] = 'index100';
mixedObj['b'] = 'firstString';
mixedObj[2] = 'index2';
mixedObj[Symbol('s2')] = 'symbol2';

console.log('Reflect.ownKeys 排序结果:', Reflect.ownKeys(mixedObj));
示例输出 (Console Output)
Reflect.ownKeys 排序结果: [ "2", "100", "z", "b", Symbol(s1), Symbol(s2) ]

从输出中可以清晰观察到:即使 100 先于 2 写入,数字索引依然以 ["2", "100"] 升序排列;随后按照插入顺序输出 "z" 和 "b";最后按照插入顺序输出两个 Symbol 键。

四、选型推导步骤与实战场景决策

在实际工程中,选择哪种遍历方式并非凭感觉盲选,而是应遵循一套清晰的条件分支决策树。图 3 梳理了完整的推导步骤:

JS遍历对象属性的5种常用方法详解
图 3:JavaScript 对象属性遍历方法选型决策流程图

常见工程场景落地建议:

  • 场景 A:常规业务数据提取与转换(最常见)
    处理用户表单提交、过滤接口入参、将字典对象转换为下拉框选项等日常场景,统一使用 Object.keys()、Object.values() 或 Object.entries()。这组 API 能彻底隔绝原型链污染与底层隐藏字段,符合“最小惊讶原则”。
  • 场景 B:深拷贝工具与 Proxy 代理反射
    在实现类似 Lodash 的 cloneDeep,或编写响应式框架的 Proxy 实例时,必须使用 Reflect.ownKeys()。若误用 Object.keys(),会导致对象内部所有的 Symbol 状态标记与不可枚举配置全部丢失。
  • 场景 C:排查类定义与框架隐藏属性
    当需要反射第三方类上的方法列表、调试被库内部设置为 enumerable: false 的配置项时,使用 Object.getOwnPropertyNames() 是排查问题的有效手段。
  • 场景 D:历史代码维护与原型继承树检查
    除非明确需要收集原型链继承而来的配置,否则尽量避免在新项目中使用 for...in。在维护旧代码时,请务必确认循环体内部包裹了 Object.hasOwn(obj, key) 守卫判断。

五、核心特性矩阵与总结

为了便于速查与记忆,下方的特性矩阵图与总结表格汇总了 5 种方法在各维度的关键特征:

JS遍历对象属性的5种常用方法详解
图 4:5 种属性遍历方法核心特性对比矩阵速查表
方法名称 自身可枚举 自身不可枚举 原型链继承 Symbol 键 返回值类型 核心优势与推荐场景
for...in ✓ 是 ✗ 否 ✓ 遍历 ✗ 否 string (迭代器) 需追溯原型链配置;必须加 Object.hasOwn 防御
Object.keys() ✓ 是 ✗ 否 ✗ 忽略 ✗ 否 string[] 日常业务最优先,纯粹且安全,无原型链副作用
Object.getOwnPropertyNames() ✓ 是 ✓ 是 ✗ 忽略 ✗ 否 string[] 审查 Class 原型方法、调试内部不可枚举配置
Object.getOwnPropertySymbols() ✓ (若Symbol) ✓ (若Symbol) ✗ 忽略 ✓ 专属 symbol[] 读取模块私有变量、扩展协议及底层元数据
Reflect.ownKeys() ✓ 是 ✓ 是 ✗ 忽略 ✓ 是 (string|symbol)[] 底层元编程利器,全量自身键捕获,深克隆/Proxy 首选

总结:JavaScript 遍历属性时出现的结果差异,并不是各 API 设计上的混乱,而是针对不同粒度与使用场景的分工。记住一条清晰的准则:普通业务用 Object.keys() 保障纯净,完整克隆/反射用 Reflect.ownKeys() 保障全面,排查隐藏用 Object.getOwnPropertyNames(),使用 for...in 时时刻警惕原型链。掌握这 5 种工具的职责边界,就能在任何复杂的数据结构处理中游刃有余。

作者最新文章
相关文章
更多