全面解析JavaScript中遍历对象属性的5种常用方法:for...in、Object.keys、Object.getOwnPropertyNames、Object.getOwnPropertySymbols与Reflect.ownKeys。从原型链、可枚举性及Symbol键三大维度深入剖析执行原理、规范遍历顺序、避坑指南与选型决策。
JS遍历对象属性的5种常用方法详解
时间:2026-11-19
浏览:402
文章目录
一、理解对象属性的三个关键维度
要准确掌握不同遍历方法的结果差异,首先必须搞清楚 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 键具有天然的防冲突和隐蔽性,绝大多数传统基于字符串的遍历接口都会直接将其略过。
如上图所示,当遍历方法执行时,它会按照自身的过滤规则对这四个象限进行筛选。只有搞清了这三个维度的交集,后续面对不同 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]}`);
}
键名: 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]}`);
});
属性名: 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);
注意事项与典型场景:
- 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]]);
读取对应值: 内部元数据
典型场景:在构建插件架构、私有状态元数据管理或实现自定义协议(如定义 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);
为什么是全量深拷贝首选?在实现真正的无损深克隆(Deep Clone)或编写 Proxy 拦截器(ownKeys trap)时,只有 Reflect.ownKeys() 能够保证不漏掉任何一个属性,确保不可枚举配置和 Symbol 键完好无损地传递给目标对象。
三、属性遍历顺序规范(ES6+ 确定性排序)
在早期 JavaScript 规范中,对象属性的遍历顺序未作强制约束,导致不同浏览器的表现曾存在细微差异。自 ES6 起,ECMAScript 规范对内部方法 [[OwnPropertyKeys]] 确立了严格、统一的排序规则。所有返回自身键数组的方法(Object.keys、Object.getOwnPropertyNames、Reflect.ownKeys)均遵循这一排序逻辑:
- 非负整数索引键:所有可以被转换为 32 位无符号整数的键(如
"0","1","10"等),无论定义先后,一律按照数值升序排序。 - 常规字符串键:其余所有非整数数字及普通字符串类型的键,严格按照其被写入对象的先后时间顺序排序。
- 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));
从输出中可以清晰观察到:即使 100 先于 2 写入,数字索引依然以 ["2", "100"] 升序排列;随后按照插入顺序输出 "z" 和 "b";最后按照插入顺序输出两个 Symbol 键。
四、选型推导步骤与实战场景决策
在实际工程中,选择哪种遍历方式并非凭感觉盲选,而是应遵循一套清晰的条件分支决策树。图 3 梳理了完整的推导步骤:
常见工程场景落地建议:
- 场景 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 种方法在各维度的关键特征:
| 方法名称 | 自身可枚举 | 自身不可枚举 | 原型链继承 | 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 种工具的职责边界,就能在任何复杂的数据结构处理中游刃有余。
实用工具推荐
绿化、压缩、噪点和虚拟水印,自由调节做旧程度。
选择画质和输出格式,预览压缩前后的大小。