JS对象转数组:Object.entries获取键值对的方法

作者:小括号

时间:2026-11-17

浏览:228

深入讲解JavaScript中使用Object.entries()将对象转换为键值对二维数组的方法,涵盖基本语法、内存映射原理、四步执行流程、典型实战场景(解构遍历、数据过滤、Map互转)及核心注意事项。

文章目录
JavaScript 核心进阶 规范标准:ECMAScript 2017 (ES8) 适用运行环境:Node.js & 现代主流浏览器
JS对象转数组:Object.entries获取键值对的方法

在 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] 数组。为了更清晰地理解这一映射过程,下图展示了内存结构上的拆解与对应关系:

JS对象转数组:Object.entries获取键值对的方法
图 1:Object.entries 数据结构解构与内存装配关系示意图

二、Object.entries 的内部执行生命周期

当我们在代码中执行 Object.entries(obj) 时,JavaScript 引擎底层并不是简单地复制指针,而是严格按照 ECMAScript 规范定义的一套确定性步骤来完成提取。理解这一内部流程,有助于我们在遇到边界数据时准确预判代码的行为。

JS对象转数组:Object.entries获取键值对的方法
图 2:Object.entries 内部执行生命周期的四步流水线流程

整个处理过程可以划分为清晰的四个阶段:

  1. 步骤一:参数校验与隐式包装(ToObject)
    引擎首先接收传入的参数。如果传入的是数值、字符串或布尔值等基本类型,引擎会自动将其转换为对应的包装对象;但如果传入的是 null 或 undefined,由于它们无法被转换为对象,引擎会立即抛出 TypeError: Cannot convert undefined or null to object。
  2. 步骤二:收集自身可枚举属性键(Filter Own Enumerable Keys)
    引擎调用底层内部方法 [[OwnPropertyKeys]] 获取对象自身定义的所有属性。此时会执行两项关键筛选:第一,排除所有 enumerable 为 false 的不可枚举属性;第二,排除所有以 Symbol 作为键名的属性。同时,遍历顺序受到严格规范保护(数字键升序排列,字符串键按添加时间排在后面)。
  3. 步骤三:逐项读取值并打包为二元组(Get and Tuple Packing)
    对于每一个筛选通过的键名,引擎调用 Get(obj, key) 读取对应的值。接着,创建一个长度为 2 的崭新数组实例,将强制转换为字符串的 key 放入索引 0,将属性的 value 放入索引 1。
  4. 步骤四:组装二维数组并返回(Array Assembly & Return)
    引擎将前面构造的各个二元组依次按序推入新创建的外层数组中,最终将该二维数组返回给调用方。

三、现代开发中的三大核心应用场景

将对象转换为二维键值对数组,并不仅仅是为了打印查看结构,而是在现代前端与后端开发中解决复杂数据转换的常规“枢纽”。以下列举最常见的三个实战场景:

JS对象转数组:Object.entries获取键值对的方法
图 3:以 Object.entries 为枢纽的核心数据流向拓扑图

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:

JS对象转数组:Object.entries获取键值对的方法
图 4:Object.entries 机制全景与特性总结看板
1. 仅提取“自身(Own)”且“可枚举(Enumerable)”的属性
如果属性是定义在对象的原型(prototype)上的,或者通过 Object.defineProperty() 设置了 enumerable: false,Object.entries() 会直接忽略该属性,不会将其加入结果数组。
2. 键名统一为字符串,忽略 Symbol 键
即使在声明对象时使用了数字作为键名(例如 { 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 属性均被自动过滤!
3. 内存浅拷贝(Shallow Copy)机制
Object.entries() 返回的外层数组以及包裹键值对的子数组都是新创建的,但属性值如果是对象、数组等复杂引用类型,传递的依然是原始对象的引用指针。修改深层对象内部的字段,原对象对应的值同样会受到影响。

五、总结与方法速查

Object.entries() 彻底解决了 JavaScript 早期需要依赖繁琐循环和临时变量来遍历或清洗对象的痛点。在开发日常中,建议遵循以下简要准则:

  • 如果只需要属性名列表,优先选用 Object.keys(obj);
  • 如果只需要属性值列表,优先选用 Object.values(obj);
  • 如果需要同时处理键与值、进行解构遍历、或者配合 .filter() 清洗后由 Object.fromEntries() 还原对象,Object.entries(obj) 是最标准、最直观的现代 JavaScript 方案。

实用工具推荐

电子包浆

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

使用 ›
图片压缩

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

使用 ›
相关文章