JS对象内置方法Object.keys与Object.entries的使用技巧
深入解析 JavaScript 内置方法 Object.keys 与 Object.entries 的使用技巧、属性枚举规则、遍历解构与数据管道重构实践。
在 JavaScript 中遍历普通对象时,很多开发者依然习惯使用传统的 for...in 循环。但 for...in 会沿着原型链检索所有可枚举属性,必须额外调用 hasOwnProperty 过滤,且无法直接融入现代函数式数组处理。ECMAScript 标准提供的两个内置静态方法 —— Object.keys 与 Object.entries,正是解决这一问题的核心工具。本文将直接从基础返回值差异切入,剖析底层属性提取规则,并深入展示结合数组解构、高阶函数以及数据管道重构的实用技巧。
一、核心定义与返回值结构解析
理解这两个方法的第一步,是精准掌握它们的返回值契约与内存形式:
Object.keys(obj):接收一个对象作为参数,返回一个由该对象自身所有可枚举属性名称组成的一维字符串数组(string[])。Object.entries(obj):接收一个对象作为参数,返回一个由该对象自身所有可枚举属性的 [key, value] 键值对组成的二维元组数组([string, any][])。
通过以下简单的示例可以直观观察其差异:
const user = {
id: 101,
name: "Alice",
role: "admin"
};
// 1. 获取所有键名
const keys = Object.keys(user);
console.log(keys);
// 示例输出: ["id", "name", "role"]
// 2. 获取所有键值对元组
const entries = Object.entries(user);
console.log(entries);
// 示例输出: [ ["id", 101], ["name", "Alice"], ["role", "admin"] ]
从输出可以看到,Object.keys 的每一个元素都是纯粹的属性名;而 Object.entries 产出的是标准化的两元数组。在获取到数组之后,开发者就可以直接调用 .length 获取属性数量,或者无缝衔接 map、filter、forEach 等所有强大的数组原型方法。
二、属性提取边界与底层枚举规则
很多初学者容易误以为 Object.keys 和 Object.entries 会捕获对象上的所有内容。实际上,根据 ECMAScript 规范的 OrdinaryOwnPropertyKeys 算法,它们在属性筛选上有四个非常明确的执行边界:
- 仅限自身属性(Own Properties):完全忽略继承自原型链(
__proto__/ prototype)的属性。无需像for...in那样编写Object.hasOwn(obj, key)防御。 - 仅限可枚举属性(Enumerable):通过
Object.defineProperty显式指定enumerable: false的属性将被自动过滤。 - 忽略 Symbol 键:若对象拥有以
Symbol为键的属性,这两个方法均不会捕获。若需抓取 Symbol 键,必须使用Object.getOwnPropertySymbols(obj)或Reflect.ownKeys(obj)。 - 属性遍历排序确定性:
- 非负整数索引键:按数值升序最优先排列(如 "1", "2", "10");
- 普通字符串键:按插入先后顺序依次排列;
- Symbol 键(若在 Reflect 模式中):按创建顺序排列在末尾。
为了加深理解,我们运行一段包含不可枚举属性、Symbol 键和原型属性的完整代码验证:
const parent = { inheritedProto: "from_prototype" };
const child = Object.create(parent);
// 自身可枚举属性
child.site = "JavaScriptCN";
child.established = 2024;
// 自身不可枚举属性
Object.defineProperty(child, "internalToken", {
value: "secret_xyz",
enumerable: false
});
// Symbol 键属性
const symKey = Symbol("auth");
child[symKey] = "symbol_value";
console.log(Object.keys(child));
// 示例输出: ["site", "established"]
console.log(Object.entries(child));
// 示例输出: [ ["site", "JavaScriptCN"], ["established", 2024] ]
在面对来自外部接口或不受信环境的配置对象时,使用 Object.keys 或 Object.entries 能够天然免疫原型链篡改与原型污染攻击,具备确定性的安全优势。
三、基础遍历技巧与解构模式
在日常业务开发中,最普遍的需求是遍历对象并使用每一项属性与值。借助 Object.entries 与 ES6 数组解构语法,可以写出兼具可读性与性能的代码。
1. 搭配 for...of 语法与元组解构
这是现代 JavaScript 遍历键值对最推荐的范式。相比 for...in,不仅省去了 obj[key] 这一步额外的哈希寻址,而且变量语义直观清晰,并且完全支持 break、continue 与 return 控制语句:
const scoreMap = {
math: 95,
english: 88,
physics: 92
};
// 使用 for...of 与 [key, value] 解构
for (const [subject, score] of Object.entries(scoreMap)) {
if (score < 90) {
console.log(`科目 ${subject} 未达到优秀标准,得分为: ${score}`);
}
}
2. 快速构造 Map 实例
JavaScript 内置的 Map 构造函数天然接受一个可迭代的键值二维数组。利用这一特性,可以将普通 Object 在一行代码内转为 Map,享受 Map 在频繁增删、键名无类型限制等方面的原生优势:
const configObj = { host: "127.0.0.1", port: 8080, ssl: true };
// 直接利用 entries 初始化 Map
const configMap = new Map(Object.entries(configObj));
console.log(configMap.get("port")); // 示例输出: 8080
console.log(configMap.has("ssl")); // 示例输出: true
四、进阶重构技巧:entries + 高阶函数 + fromEntries 管道
在 ES2019 引入 Object.fromEntries 之前,想要对一个对象进行类似数组的 filter 或 map 操作,开发者通常需要先声明一个空的临时对象,然后在循环体中手动赋值。这种命令式写法不仅繁琐,而且容易引入可变状态带来的副作用。
而现在,借助 Object.entries ➔ 数组高阶算子 ➔ Object.fromEntries 的三段式管道,我们可以用优雅、纯粹的函数式风格完成任何复杂的对象变换。
技巧一:按值过滤对象属性(去除空字段/特定值)
在向后端提交表单或发起 HTTP 请求前,常常需要剔除对象中值为 null、undefined 或空字符串的冗余字段:
function compactObject(target) {
return Object.fromEntries(
Object.entries(target).filter(([_, value]) => {
return value !== null && value !== undefined && value !== "";
})
);
}
const formData = {
username: "developer_01",
email: "dev@example.com",
age: 0, // 应当保留合法的 0
nickname: "", // 需过滤
avatar: null // 需过滤
};
const cleanData = compactObject(formData);
console.log(cleanData);
// 示例输出: { username: "developer_01", email: "dev@example.com", age: 0 }
技巧二:批量转换键名或数值(大小写归一化、单位折算)
通过在 .map() 回调中返回修改后的 [newKey, newValue],可以极其轻松地完成对象维度的字段映射:
// 场景:将价格字典批量折算为含税价格并格式化
const rawPrices = { apple: 10, banana: 6, orange: 15 };
const TAX_RATE = 1.13;
const taxedPrices = Object.fromEntries(
Object.entries(rawPrices).map(([fruit, price]) => [
fruit.toUpperCase(), // 键名大写
Number((price * TAX_RATE).toFixed(2)) // 值折算并保留两位小数
])
);
console.log(taxedPrices);
// 示例输出: { APPLE: 11.3, BANANA: 6.78, ORANGE: 16.95 }
技巧三:URL 查询参数序列化与逆解析
当需要手动拼装 URL 的 Query String 时,Object.entries 可以与 encodeURIComponent 和 join 无缝协同:
function buildQueryString(params) {
return Object.entries(params)
.filter(([_, val]) => val !== undefined && val !== null)
.map(([key, val]) => `${encodeURIComponent(key)}=${encodeURIComponent(String(val))}`)
.join("&");
}
const queryParams = { page: 1, keyword: "react & vue", sort: "desc" };
console.log(buildQueryString(queryParams));
// 示例输出: "page=1&keyword=react%20%26%20vue&sort=desc"
五、边界陷阱与工程实践防御指南
在生产环境编写基础工具函数时,必须清楚理解内置方法的极端输入边界与底层特性:
1. 非对象输入的兼容与异常防御
在早期 ES5 环境中,向 Object.keys 传入非对象原始类型(如数字或字符串)会直接抛出 TypeError。在现代 ES6+ 规范中,原始值会被强制转换为对应的包装对象(如字符串转为字符索引对象,数值和布尔值转为无自身属性的包装对象)。
但是,null 和 undefined 无论在任何规范版本中,都会抛出 TypeError:
// 安全边界提示
Object.keys("ABC"); // 转换为包装对象,输出: ["0", "1", "2"]
Object.keys(12345); // 基础数值无自身属性,输出: []
try {
Object.entries(null); // 抛出: TypeError: Cannot convert undefined or null to object
} catch (err) {
console.error("防御捕获:", err.message);
}
编写接受外部入参的公共函数时,始终建议使用默认参数或空值合并运算符(Nullish Coalescing)进行短路保护:Object.entries(inputObj ?? {}),防止程序因未初始化的变量崩溃。
2. 内存占用与大数据量权衡
Object.keys 和 Object.entries 属于即时求值(Eager Evaluation)操作。当调用 Object.entries(largeObject) 时,V8 引擎会在内存中立即创建与属性等量数量的双层数组结构。对于包含几十万级属性的大型缓存对象,这会瞬间触发明显的内存分配和垃圾回收(GC)开销。若面对超大对象且只读少量项,应当优先考虑使用自定义生成器(Generator)进行惰性求值。
六、技术选型矩阵与总结
为了帮助大家在日常编码中快速决断,下表汇总了相关内置方法的核心属性与最佳落地场景:
| 方法名称 | 返回值类型 | 枚举范围 | 推荐最佳适用场景 |
|---|---|---|---|
Object.keys(obj) |
string[] |
自身可枚举字符串属性 | 判断对象是否为空 (.length === 0)、统计字段数、属性白名单检测 |
Object.values(obj) |
any[] |
自身可枚举属性对应值 | 仅关注数值的聚合计算(求和、均值)、状态集包含判断 (.includes()) |
Object.entries(obj) |
[string, any][] |
自身可枚举 [键, 值] 二维元组 | 键值联动遍历、for...of 解构、Map 初始化、对象过滤与重构管道 |
Object.fromEntries(arr) |
Record<string, any> |
二维元组或可迭代迭代器 | 作为 entries 转换管道的终端闭环,将过滤或映射后的数组还原为全新对象 |
熟练运用 Object.keys 与 Object.entries,不仅能够彻底摆脱传统 for...in 的原型污染隐患与冗余防御代码,更重要的是打通了“对象”与“数组”两种基础数据结构之间的壁垒。结合 Object.fromEntries,我们可以用更清晰、无副作用的函数式管道重塑对象数据流,显著提升代码的健壮性与可维护性。
JS验证中国大陆手机号的标准正则表达式
2026-11-18 11:25:28
JSON格式字符串怎么安全转为JS数组
2026-11-18 08:46:32
HTML引入JS后脚本报错或变量未定义的排查思路
2026-11-17 23:17:44
为什么JS函数表达式不能在定义前调用?
2026-11-17 22:52:00
JS格式化JSON遇到Circular Structure循环引用报错怎么解决
2026-11-17 22:45:37






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

