JS对象转数组:Object.keys、values与entries用法详解

作者:纸飞机时间:2026-11-19 09:34:21浏览:247

深入详解 JavaScript 中将对象转换为数组的三个核心静态方法:Object.keys、Object.values 与 Object.entries。涵盖数据结构差异、实际应用场景、转换流水线、遍历边界条件及选型建议。

JavaScript 核心基础 适用标准:ES2017 (ES8) 及以上 阅读时间:约 7 分钟

在 JavaScript 日常开发中,普通对象(Plain Object)被设计为由无序键值对组成的映射表。由于对象本身不具备 map、filter、reduce 等数组原型方法,当我们需要对属性进行计数、筛选、重塑或循环遍历时,最有效且规范的手段就是将对象转为数组。ECMAScript 提供了三个原生静态方法:Object.keys() 提取键名、Object.values() 提取键值、Object.entries() 提取键值元组。本文将系统梳理这三个方法的数据结构差异、实际应用场景、属性边界与遍历排序规则,帮助你在不同业务逻辑中做出准确选择。

JS对象转数组:Object.keys、values与entries用法详解
图 0:Object.keys、values 与 entries 将对象拆解为不同形态数组的映射概览

一、三种方法的核心映射与数据结构区别

理解这三个方法的第一步,是认清它们在数据结构上的输出维度。虽然三者都接收一个对象作为输入并返回一个全新的数组,但数组元素的类型与信息维度截然不同:

  • Object.keys(obj):返回一个一维字符串数组(Array<string>),包含对象自身的所有可枚举属性名。即便对象的键在书写时是数字,在返回数组中也会统一被表示为字符串。
  • Object.values(obj):返回一个一维值数组(Array<any>),包含对象自身所有可枚举属性对应的具体值,保留值原本的类型(数值、布尔值、嵌套对象等)。
  • Object.entries(obj):返回一个二维嵌套数组(Array<[string, any]>),外层数组的每个元素都是一个固定长度为 2 的数组(元组),形如 [key, value]。该方法完整保留了键与值之间的对应关系。
JS对象转数组:Object.keys、values与entries用法详解
图 1:三种方法在内存输出结构、维度及典型用途上的深度对比

以下代码直观展示了对同一个对象调用这三个方法时的输出差别:

// 示例对象:商品库存记录
const product = {
  sku: "A-99",
  price: 299,
  stock: 15,
  isDiscount: false
};

// 1. 获取所有键名
const keys = Object.keys(product);
// 输出示例: ["sku", "price", "stock", "isDiscount"]

// 2. 获取所有键值
const values = Object.values(product);
// 输出示例: ["A-99", 299, 15, false]

// 3. 获取所有键值对
const entries = Object.entries(product);
// 输出示例: [
//   ["sku", "A-99"],
//   ["price", 299],
//   ["stock", 15],
//   ["isDiscount", false]
// ]

二、方法详解与高频实战场景

1. Object.keys():属性检验与模式校验

当业务逻辑只关心“存在哪些属性”,或者需要验证对象是否具有某些字段时,Object.keys() 是最直接的方案。

场景 A:最可靠的空对象检测
在 JavaScript 中,直接用 obj === {} 无法检测空对象,因为两个空对象的内存引用地址不同。常规做法是通过检查属性数量:

function isEmptyObject(obj) {
  return Object.keys(obj).length === 0;
}

const formConfig = {};
console.log(isEmptyObject(formConfig)); // 输出示例: true

场景 B:白名单字段安全过滤
在处理客户端提交的表单数据时,常常需要判断提交内容是否超出了允许提交的字段范围:

const allowedFields = ["username", "email", "age"];
const userPayload = { username: "alice", email: "a@test.com", role: "superadmin" };

const invalidKeys = Object.keys(userPayload).filter(key => !allowedFields.includes(key));
if (invalidKeys.length > 0) {
  console.warn("检测到非法提交字段:", invalidKeys);
  // 输出示例: 检测到非法提交字段: ["role"]
}

2. Object.values():数据汇总与内容提取

当对象被用作哈希字典(Hash Table),且业务逻辑只需要对数据本身进行累计、统计或判定时,使用 Object.values() 可以省去反复通过 obj[key] 寻址的麻烦。

场景 A:数值汇总与财务统计
例如,统计购物车中所有分类商品的数量总和或总花费:

const monthlyExpenses = {
    housing: 3200,
    food: 1800,
    transport: 400,
    utilities: 350
};

// 直接通过 values 获取数值数组并执行累加
const totalCost = Object.values(monthlyExpenses).reduce((acc, current) => acc + current, 0);
console.log("本月总开支:", totalCost); // 输出示例: 本月总开支: 5750

场景 B:状态检测
校验表单验证字典中是否存在校验未通过的项:

const fieldValidity = {
  username: true,
  email: true,
  password: false
};

// 是否所有字段都验证通过
const isFormValid = Object.values(fieldValidity).every(status => status === true);
console.log("表单整体是否有效:", isFormValid); // 输出示例: false

3. Object.entries():对象的高阶变换流水线

Object.entries() 的价值在于打通了“对象”与“数组高阶算子”之间的壁垒。由于它生成的是 [key, value] 数组,配合 ES2019 引入的 Object.fromEntries(),可以让对象像数组一样进行自由的过滤、映射和重构。

JS对象转数组:Object.keys、values与entries用法详解
图 2:基于 Object.entries 与 Object.fromEntries 的对象数据变形处理流水线

场景 A:使用 for...of 进行解构循环
比传统的 for...in 循环更安全、语法更清晰,无需手动调用 hasOwnProperty:

const systemSettings = {
  theme: "dark",
  fontSize: 14,
  autoSave: true
};

for (const [settingKey, settingValue] of Object.entries(systemSettings)) {
  console.log(`设置项: ${settingKey} => ${settingValue}`);
}
// 输出示例:
// 设置项: theme => dark
// 设置项: fontSize => 14
// 设置项: autoSave => true

场景 B:过滤并转换对象(Filter & Map Pipeline)
在实际接口交互中,经常需要过滤掉所有为 null、undefined 或空字符串的请求参数:

const queryParams = {
  keyword: "javascript",
  category: "frontend",
  page: 1,
  limit: 20,
  tag: null,        // 需过滤
  order: undefined   // 需过滤
};

// entries -> 数组过滤 -> fromEntries 还原为对象
const cleanParams = Object.fromEntries(
  Object.entries(queryParams).filter(([_, value]) => value !== null && value !== undefined)
);

console.log(cleanParams);
// 输出示例: { keyword: "javascript", category: "frontend", page: 1, limit: 20 }

三、核心机制:属性过滤规则与边界陷阱

在深入使用这三个方法时,如果不清楚 JavaScript 引擎提取属性的边界条件,很容易引发难以排查的隐性 Bug。以下是必须牢记的四项底层规则:

JS对象转数组:Object.keys、values与entries用法详解
图 3:JavaScript 属性提取 API 的作用边界与可见性过滤规则矩阵

1. 仅提取“自有可枚举属性”(Own Enumerable)

这三个静态方法会严格忽略两类属性:

  1. 原型链继承属性:即使原型上有可枚举属性,三者也不会读取。这与 for...in 循环有本质区别。因此使用三者无需写 Object.hasOwn(obj, key)。
  2. 不可枚举属性(Non-enumerable):通过 Object.defineProperty() 显式指定 enumerable: false 的属性,或者系统内置的不可枚举属性(如数组的 length、原型的 toString),均会被静默跳过。
const baseProto = { inheritedKey: "来自原型链" };
const myObj = Object.create(baseProto);

// 定义自有可枚举属性
myObj.ownKey = "自有内容";

// 定义自有不可枚举属性
Object.defineProperty(myObj, "hiddenKey", {
  value: "保密数据",
  enumerable: false
});

console.log(Object.keys(myObj));
// 输出示例: ["ownKey"] (inheritedKey 和 hiddenKey 均被忽略)
避坑提醒:如果对象中存在通过不可枚举定义的私有字段,或者需要获取 Symbol 属性,Object.keys()、values() 和 entries() 都不会包含它们。若需提取全部自有属性(包括不可枚举),应使用 Object.getOwnPropertyNames();若需包含 Symbol 键,应使用 Reflect.ownKeys()。

2. 忽略 Symbol 键

ES6 引入了 Symbol 作为对象的属性键名。但是,Object.keys()、values()、entries() 均不处理 Symbol 键:

const idSymbol = Symbol("internal_id");
const record = {
  [idSymbol]: 8888,
  title: "任务指南"
};

console.log(Object.keys(record));   // 输出示例: ["title"]
console.log(Object.values(record)); // 输出示例: ["任务指南"]
// 若需获取 Symbol 属性值,需借助 Object.getOwnPropertySymbols(record)

3. 遍历顺序规范(ES6 规范化规定)

在早期浏览器中,对象键的遍历顺序未在规范中严格统一。自 ES2015 (ES6) 起,属性枚举顺序有了明确的确定性标准:

  • 非负整数键:能够转换为 32 位无符号整数的键(如 "0"、"1"、"5"),会优先按数字数值升序排列。
  • 常规字符串键:其余普通字符串键,按照属性被创建并添加到对象的时间先后顺序排列。
const disordered = {
  "b": "second",
  "10": "num2",
  "a": "third",
  "2": "num1"
};

console.log(Object.keys(disordered));
// 输出示例: ["2", "10", "b", "a"] (数字先升序,字符串按写入顺序)

4. 传入非对象参数时的行为表现

在实际代码中,若接口数据偶发性返回原始类型(如字符串、数值),三个方法的行为如下:

  • ES5 环境:传入非对象类型(如 Object.keys("abc"))会直接抛出 TypeError。
  • ES2015+ 环境:非对象参数会被强制转换为对应的包装对象(Object Coercion)。例如对字符串 "cat" 调用 Object.keys("cat"),会视其为 new String("cat"),返回索引数组 ["0", "1", "2"]。
  • null 与 undefined:无论任何规范版本,传入 null 或 undefined 均无法被转换为对象,都会抛出 TypeError: Cannot convert undefined or null to object。在调用前应确保进行空值守卫(如配合可选链或三元判断)。

四、选型决策指南与总结

为了在实际开发中快速选用恰当的方法,可以参考以下场景决策图:

JS对象转数组:Object.keys、values与entries用法详解
图 4:对象转数组方法选择决策树与场景推荐

三者在功能、返回值类型及链式组合场景下的对比如下表所示:

方法 返回值类型 核心信息目标 常用后续链式操作 典型业务场景
Object.keys(obj) string[] 仅属性名(键) .length, .includes(), .filter() 判空、Schema 白名单比对、字段计数
Object.values(obj) any[] 仅属性值(内容) .reduce(), .every(), .find() 数值累加、状态检测、下拉选项渲染
Object.entries(obj) [string, any][] 完整键值对元组 .map(), .filter() + fromEntries 对象结构重塑、字典裁剪、for...of 遍历
性能与内存考量:这三个方法在每次执行时,都会在堆内存中新分配一个数组实例。如果在一个处理高频事件(例如 requestAnimationFrame 或高频滚动事件)的热点循环中,频繁对包含大量键值的大对象调用 Object.entries(),会导致大量临时小数组对象的创建并加剧垃圾回收(GC)开销。在此类极致性能场景中,建议优先考虑原生的 for (const key in obj) 搭配缓存对象,或改用具备天然迭代能力的 Map 结构。

总结而言,Object.keys、Object.values 和 Object.entries 分别从“键”、“值”和“键值对”三个视角,为无序的 JavaScript 对象搭建了通往功能强大的数组 API 的桥梁。掌握它们各自的数据结构特征与枚举边界,能够使你的数据处理逻辑既简洁又具备防御性。

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