深入讲解JavaScript中使用Object.entries()将对象转换为键值对二维数组的方法,涵盖基本语法、内存映射原理、四步执行流程、典型实战场景(解构遍历、数据过滤、Map互转)及核心注意事项。
JS对象转数组:Object.entries获取键值对的方法
时间:2026-11-17
浏览:228
文章目录
在 JavaScript 开发中,普通 Object 是由键值对构成的集合,但它本身并不具备迭代器接口(Iterable),也无法直接调用数组的 map、filter、reduce 等高阶方法。如果需要将一个对象完整转换为数组并同时保留其“属性名”与“属性值”,最规范、最高效的方法是使用标准 API —— Object.entries()。该方法接收一个目标对象,返回一个由 [key, value] 构成的二维数组,从而彻底打通对象到数组工具链的通道。
一、Object.entries 的基础语法与结构解析
Object.entries() 是 ECMAScript 2017(ES8)正式引入的静态方法。它的调用形式非常简洁,直接挂载在全局 Object 构造函数上:
const entriesArray = Object.entries(targetObject);
方法的唯一参数 targetObject 是待转换的目标对象。它的返回值是一个崭新的二维数组,其中每一个子数组(元组)均包含且仅包含两个元素:
- 子数组索引 0:当前属性的键名(类型固定为字符串
string)。 - 子数组索引 1:该属性对应的具体属性值(类型与原对象中保存的值完全一致)。
我们通过一段具体的示例代码来观察它的转换结果:
const developer = {
name: 'Alex',
role: 'Frontend Engineer',
level: 4,
isActive: true
};
const result = Object.entries(developer);
console.log(result);
// 终端示例输出:
// [
// [ 'name', 'Alex' ],
// [ 'role', 'Frontend Engineer' ],
// [ 'level', 4 ],
// [ 'isActive', true ]
// ]
从输出可以看出,原本属于对象内部的每个键值属性对,都被有序装配成了一个独立的 [key, value] 数组。为了更清晰地理解这一映射过程,下图展示了内存结构上的拆解与对应关系:
二、Object.entries 的内部执行生命周期
当我们在代码中执行 Object.entries(obj) 时,JavaScript 引擎底层并不是简单地复制指针,而是严格按照 ECMAScript 规范定义的一套确定性步骤来完成提取。理解这一内部流程,有助于我们在遇到边界数据时准确预判代码的行为。
整个处理过程可以划分为清晰的四个阶段:
-
步骤一:参数校验与隐式包装(ToObject)
引擎首先接收传入的参数。如果传入的是数值、字符串或布尔值等基本类型,引擎会自动将其转换为对应的包装对象;但如果传入的是null或undefined,由于它们无法被转换为对象,引擎会立即抛出TypeError: Cannot convert undefined or null to object。 -
步骤二:收集自身可枚举属性键(Filter Own Enumerable Keys)
引擎调用底层内部方法[[OwnPropertyKeys]]获取对象自身定义的所有属性。此时会执行两项关键筛选:第一,排除所有enumerable为false的不可枚举属性;第二,排除所有以Symbol作为键名的属性。同时,遍历顺序受到严格规范保护(数字键升序排列,字符串键按添加时间排在后面)。 -
步骤三:逐项读取值并打包为二元组(Get and Tuple Packing)
对于每一个筛选通过的键名,引擎调用Get(obj, key)读取对应的值。接着,创建一个长度为 2 的崭新数组实例,将强制转换为字符串的key放入索引 0,将属性的value放入索引 1。 -
步骤四:组装二维数组并返回(Array Assembly & Return)
引擎将前面构造的各个二元组依次按序推入新创建的外层数组中,最终将该二维数组返回给调用方。
三、现代开发中的三大核心应用场景
将对象转换为二维键值对数组,并不仅仅是为了打印查看结构,而是在现代前端与后端开发中解决复杂数据转换的常规“枢纽”。以下列举最常见的三个实战场景:
1. 结合 for...of 优雅解构遍历对象
过去遍历对象常常使用 for...in 循环,但 for...in 会意外遍历到原型链上的继承属性,往往还需要手动嵌套一层 hasOwnProperty 校验;而使用 Object.keys() 遍历时,又必须在循环体内部通过 obj[key] 再次寻址取值。
通过 Object.entries() 配合 ES6 的数组解构语法,不仅语义清晰,而且一次性就能同时获得键和值:
const appConfig = {
host: '127.0.0.1',
port: 8080,
protocol: 'https'
};
// 使用 for...of 直接解构 [key, value]
for (const [key, value] of Object.entries(appConfig)) {
console.log(`配置项: ${key} => 对应设定: ${value}`);
}
// 终端示例输出:
// 配置项: host => 对应设定: 127.0.0.1
// 配置项: port => 对应设定: 8080
// 配置项: protocol => 对应设定: https
2. 配合 filter 与 Object.fromEntries 实现对象属性清洗
在处理表单数据或接口响应时,我们常常需要剔除空值、未激活项或不达标的数据。由于普通对象没有原生的 .filter() 方法,开发者经常需要写很多行命令式代码。借助 Object.entries() 与 ES2019 的 Object.fromEntries(),我们可以写出优雅的声明式转换管道:
const studentScores = {
chinese: 95,
math: 88,
english: 52,
physics: 76,
art: 59
};
// 目标:只保留成绩 >= 60 的及格科目,并重新组装为对象
const passedScores = Object.fromEntries(
Object.entries(studentScores).filter(([subject, score]) => score >= 60)
);
console.log(passedScores);
// 终端示例输出:
// { chinese: 95, math: 88, physics: 76 }
3. 快速将对象转化为 Map 实例
ECMAScript 中的 Map 构造函数接受一个可迭代的键值对集合(如 [[key1, val1], [key2, val2]])作为初始化参数。Object.entries() 返回的结构与 Map 构造器的输入要求完美契合,使得普通对象与 Map 之间的转换只需一行代码:
const rawSettings = { theme: 'dark', notifications: true };
// 传入二维数组直接实例化 Map
const settingsMap = new Map(Object.entries(rawSettings));
console.log(settingsMap.has('theme')); // true
console.log(settingsMap.get('theme')); // 'dark'
四、关键特性与易混淆注意事项
在实际项目中使用 Object.entries() 时,有几个容易被忽略但至关重要的技术细节,如果理解不准确可能会导致隐藏的 Bug:
如果属性是定义在对象的原型(
prototype)上的,或者通过 Object.defineProperty() 设置了 enumerable: false,Object.entries() 会直接忽略该属性,不会将其加入结果数组。
即使在声明对象时使用了数字作为键名(例如
{ 10: 'ten' }),返回的子数组中索引 0 的键依然是字符串 '10'。此外,若对象包含以
Symbol() 为键的属性,Object.entries() 会完全跳过。若业务需要收集 Symbol 键,应搭配 Reflect.ownKeys() 处理。
以下代码直观展示了这些边界场景:
const parent = { inheritedProp: 'from prototype' };
const child = Object.create(parent);
child.normalKey = 'visible';
child[42] = 'numeric key';
child[Symbol('secret')] = 'hidden symbol';
// 定义不可枚举属性
Object.defineProperty(child, 'nonEnum', {
value: 'cannot see me',
enumerable: false
});
console.log(Object.entries(child));
// 终端示例输出:
// [
// [ '42', 'numeric key' ], // 数字键排在最前并转为字符串
// [ 'normalKey', 'visible' ] // 正常可枚举属性
// ]
// 继承属性、不可枚举属性以及 Symbol 属性均被自动过滤!
Object.entries() 返回的外层数组以及包裹键值对的子数组都是新创建的,但属性值如果是对象、数组等复杂引用类型,传递的依然是原始对象的引用指针。修改深层对象内部的字段,原对象对应的值同样会受到影响。
五、总结与方法速查
Object.entries() 彻底解决了 JavaScript 早期需要依赖繁琐循环和临时变量来遍历或清洗对象的痛点。在开发日常中,建议遵循以下简要准则:
- 如果只需要属性名列表,优先选用
Object.keys(obj); - 如果只需要属性值列表,优先选用
Object.values(obj); - 如果需要同时处理键与值、进行解构遍历、或者配合
.filter()清洗后由Object.fromEntries()还原对象,Object.entries(obj)是最标准、最直观的现代 JavaScript 方案。
实用工具推荐
绿化、压缩、噪点和虚拟水印,自由调节做旧程度。
选择画质和输出格式,预览压缩前后的大小。