JS对象转数组:Object.keys、values与entries用法详解
深入详解 JavaScript 中将对象转换为数组的三个核心静态方法:Object.keys、Object.values 与 Object.entries。涵盖数据结构差异、实际应用场景、转换流水线、遍历边界条件及选型建议。
在 JavaScript 日常开发中,普通对象(Plain Object)被设计为由无序键值对组成的映射表。由于对象本身不具备 map、filter、reduce 等数组原型方法,当我们需要对属性进行计数、筛选、重塑或循环遍历时,最有效且规范的手段就是将对象转为数组。ECMAScript 提供了三个原生静态方法:Object.keys() 提取键名、Object.values() 提取键值、Object.entries() 提取键值元组。本文将系统梳理这三个方法的数据结构差异、实际应用场景、属性边界与遍历排序规则,帮助你在不同业务逻辑中做出准确选择。
一、三种方法的核心映射与数据结构区别
理解这三个方法的第一步,是认清它们在数据结构上的输出维度。虽然三者都接收一个对象作为输入并返回一个全新的数组,但数组元素的类型与信息维度截然不同:
- Object.keys(obj):返回一个一维字符串数组(
Array<string>),包含对象自身的所有可枚举属性名。即便对象的键在书写时是数字,在返回数组中也会统一被表示为字符串。 - Object.values(obj):返回一个一维值数组(
Array<any>),包含对象自身所有可枚举属性对应的具体值,保留值原本的类型(数值、布尔值、嵌套对象等)。 - Object.entries(obj):返回一个二维嵌套数组(
Array<[string, any]>),外层数组的每个元素都是一个固定长度为 2 的数组(元组),形如[key, value]。该方法完整保留了键与值之间的对应关系。
以下代码直观展示了对同一个对象调用这三个方法时的输出差别:
// 示例对象:商品库存记录
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(),可以让对象像数组一样进行自由的过滤、映射和重构。
场景 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。以下是必须牢记的四项底层规则:
1. 仅提取“自有可枚举属性”(Own Enumerable)
这三个静态方法会严格忽略两类属性:
- 原型链继承属性:即使原型上有可枚举属性,三者也不会读取。这与
for...in循环有本质区别。因此使用三者无需写Object.hasOwn(obj, key)。 - 不可枚举属性(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 均被忽略)
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。在调用前应确保进行空值守卫(如配合可选链或三元判断)。
四、选型决策指南与总结
为了在实际开发中快速选用恰当的方法,可以参考以下场景决策图:
三者在功能、返回值类型及链式组合场景下的对比如下表所示:
| 方法 | 返回值类型 | 核心信息目标 | 常用后续链式操作 | 典型业务场景 |
|---|---|---|---|---|
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 的桥梁。掌握它们各自的数据结构特征与枚举边界,能够使你的数据处理逻辑既简洁又具备防御性。
JS字符串逐字符转数组时Emoji被截断怎么办
2026-11-19 09:00:36
JavaScript数组去重的5种常用方法对比
2026-11-18 22:16:06
解决JavaScript for循环中setTimeout延迟执行失效的问题
2026-11-18 21:42:02
JS字符串处理算法题实战:回文判断与最长子串查找
2026-11-18 19:48:13
JS箭头函数怎么隐式返回对象:括号用法详解
2026-11-18 19:07:40






![为什么JS对象直接转字符串显示[object Object]](https://img.javascript.cn/tit/articles/13236/20261106/84aa86eb15b66540a3d64b4a7a62b181d4058395daf4aec8f716e9fa4f562f53.webp)

