深入讲解如何使用 JavaScript 原生方法 Object.values() 快速提取普通对象的所有自身属性值,涵盖规范运行机制、属性排序规则、可枚举过滤机制、实战场景及常见注意事项。
使用Object.values快速获取JS对象的所有属性值
时间:2026-11-21
浏览:646
文章目录
Object.values()。该方法于 ECMAScript 2017(ES8)正式加入语言标准,它接收目标对象作为参数,返回一个包含该对象所有自身可枚举属性值的一维数组,无需手写循环或配合 hasOwnProperty 过滤。
一、基本语法与返回值结构
在 ES2017 之前,若想获取对象全部的值,开发者通常需要通过 Object.keys() 取得所有属性名,再借助 map() 方法遍历对象取值,或者通过 for...in 循环手动向数组追加元素。这不仅书写繁琐,而且容易误伤原型链上的属性。
Object.values() 提供了语义明确的一步到位方案,其语法形式极为直接:
// 语法规范
const values = Object.values(obj);
参数 obj 表示需要提取属性值的源对象。返回值是由目标对象自身属性值构成的标准 JavaScript 数组(Array 实例)。
来看一个基础示例:
const book = {
title: "JavaScript 核心指南",
pages: 320,
isPublished: true
};
const values = Object.values(book);
console.log(values);
返回结果是纯净的一维数组,这意味着你可以立即无缝使用数组的所有原生高阶方法,例如 .map()、.filter()、.includes()、.reduce() 或展开运算符(Spread Operator)。
二、内部执行机制与值排序规则
很多开发者认为对象中的键值对是“无序”的,因而在使用 Object.values() 时会对数组元素的排列次序产生疑虑。根据 ECMAScript 规范定义,Object.values() 内部遵循严格的 EnumerableOwnPropertyNames 执行流程,元素的排列顺序具有确定性规范。
从底层机制来看,Object.values(obj) 的执行会经历四个核心阶段:
-
类型装箱(ToObject):如果传入的是原始基本类型(例如字符串、数值、布尔值),JavaScript 会先将其包装成对应的对象实体;如果传入
null或undefined,规范规定直接抛出TypeError异常。 -
确定自身可枚举键的排列顺序:提取属性时,属性键严格按照以下次序依次排布:
- 非负整数索引键:按照数值大小升序排列(例如
1, 2, 10会排在前面且按由小到大排列); - 常规字符串键:按照属性被创建或插入的先后顺序紧随其后;
- Symbol 类型键:在此阶段被完全忽略,不进入列表。
- 非负整数索引键:按照数值大小升序排列(例如
-
可枚举性双重过滤:引擎逐一核对属性描述符(Property Descriptor),仅保留满足
enumerable: true且属于对象自身(Own Property)的属性。 - 读取值并生成数组:引擎依次根据排序后的键名获取属性值,组装并返回一个崭新的数组实例。
我们可以通过一段具体的混合键顺序示例来观察这一规律:
const mixedObj = {
"b": "字母 B",
2: "数字二",
"a": "字母 A",
1: "数字一"
};
const result = Object.values(mixedObj);
console.log(result);
从结果可以看到,尽管在代码声明时 "b" 写在最前面,但整数键 1 和 2 被优先按升序排在了前面,随后才是按书写顺序出现的 "b" 与 "a"。这种排序规则保证了与 Object.keys() 以及 for...in 在规范层面的一致性。
三、属性提取规则与边界对照
明确 Object.values() 到底会提取哪些属性、忽略哪些属性,是避免业务中产生隐蔽 Bug 的关键。
在 JavaScript 复杂对象模型中,属性存在多种存在形式。Object.values() 的过滤边界总结如下:
| 属性分类 | 定义形式与典型场景 | Object.values() 处理表现 |
|---|---|---|
| 自身可枚举普通属性 | 字面量直接定义、直接赋值 obj.x = 1 |
✔ 正常提取:按规范顺序出现在返回数组中 |
| 不可枚举属性 | 通过 Object.defineProperty(obj, key, { enumerable: false }) 定义 |
✘ 自动忽略:不会出现在返回值中 |
| 原型链继承属性 | 挂载在 prototype 上的属性或父类属性 |
✘ 自动忽略:天然具备隔离性,不跨越原型链 |
| Symbol 键属性 | 以 Symbol('id') 作为属性名 |
✘ 自动忽略:需使用专用反射 API 提取 |
不可枚举与原型链属性过滤演示
以下代码展示了当对象混合了原型属性与不可枚举属性时,Object.values() 的实际处理行为:
// 1. 创建原型对象并定义继承属性
const proto = { inherited: "来自原型的属性" };
const target = Object.create(proto);
// 2. 添加自身普通可枚举属性
target.active = true;
target.count = 42;
// 3. 添加自身不可枚举属性
Object.defineProperty(target, "hiddenToken", {
value: "SECRET_999",
enumerable: false
});
// 4. 添加 Symbol 键属性
const symKey = Symbol("internalId");
target[symKey] = "SYM_1001";
console.log(Object.values(target));
可以看到,继承的 inherited、不可枚举的 hiddenToken 以及 Symbol 键对应的值都被精准剔除,仅输出了对象自身的普通可枚举属性值。
四、四个高频实战应用场景
由于 Object.values() 返回的是纯数组,它能够无缝融入现代前端或 Node.js 的函数式处理链。以下是日常编码中最常用的四个实用场景。
1. 统计数据求和与指标汇总
当后端接口或本地状态返回字典形式的分组数值时,无需关注分类名称,直接将对象值提取出来进行规约计算:
const monthlyExpenses = {
rent: 3500,
food: 1800,
utilities: 320,
transport: 450
};
// 使用 Object.values() 配合 reduce 完成总和累加
const totalExpense = Object.values(monthlyExpenses).reduce(
(accumulator, current) => accumulator + current,
0
);
console.log(`本月总支出: ${totalExpense} 元`);
2. 表单多字段批量状态校验
在前端交互中,经常需要确认表单所有必填字段是否都已填写,或者所有状态开关是否全部处于开启状态:
const formValidationState = {
usernameValid: true,
emailValid: true,
phoneValid: false,
passwordValid: true
};
// 检查是否全部校验通过
const isFormReady = Object.values(formValidationState).every(Boolean);
// 检查是否存在任何一个失败字段
const hasAnyError = Object.values(formValidationState).some(state => !state);
console.log("表单整体就绪:", isFormReady);
console.log("是否存在错误:", hasAnyError);
3. 提取枚举字典为前端下拉列表选项
后台接口常通过常量映射表(Enum Map)传递业务枚举,前端 UI 组件往往需要数组格式来渲染下拉菜单:
const STATUS_MAP = {
DRAFT: { code: "DRAFT", label: "草稿待审" },
PENDING: { code: "PENDING", label: "审批处理中" },
APPROVED: { code: "APPROVED", label: "已批准发布" }
};
// 直接提取字典中的子对象作为下拉菜单选项列表
const dropdownOptions = Object.values(STATUS_MAP);
console.log(dropdownOptions);
4. 快速搜索或判断特定数值是否存在
当无需知道属性键,只需判断某个具体值是否隶属于该实体时,结合 .includes() 是最简洁的书写方式:
const rolePermissions = {
editor: "WRITE_POST",
admin: "MANAGE_USERS",
auditor: "VIEW_LOGS"
};
const canManageUsers = Object.values(rolePermissions).includes("MANAGE_USERS");
console.log("系统包含管理用户权限:", canManageUsers);
五、Object 反射方法对比与协作
Object.values() 并不是孤立存在的,它与 ES5 的 Object.keys() 以及 ES8 的 Object.entries() 共同构成了现代 JavaScript 对象反射的三大支柱。
在具体开发中,开发者应当根据当前任务的最小信息集原则进行选型:
- 仅关注内容/值:选用
Object.values(obj)。减少不必要的键名传递,使代码意图更聚焦。 - 仅关注键名/属性存在性:选用
Object.keys(obj)。例如通过Object.keys(obj).length === 0快速检测空对象。 - 需同时转换键与值:选用
Object.entries(obj)。常用于将普通对象转为new Map(),或者配合Object.fromEntries()对对象进行过滤和映射重建。
六、边界情况与常见陷阱排查
虽然 Object.values() 语法简单,但在处理非标准入参或特殊结构时仍有几点需要特别注意。
1. 传入非对象原始类型参数
当传入字符串时,字符串会被装箱为带有数值索引属性的 String 包装对象,每个字符都会被作为属性值提取:
console.log(Object.values("Hello"));
// 字符串转为各个单字符构成的数组
当传入数值或布尔值时,包装对象自身没有任何可枚举属性,因此会安全地返回空数组,不会报错:
console.log(Object.values(12345)); // 输出 []
console.log(Object.values(true)); // 输出 []
与数值不同,null 和 undefined 无法被装箱为对象。直接向 Object.values() 传入它们会抛出 TypeError: Cannot convert undefined or null to object。
防御性写法建议:当目标变量可能为空时,采用可选链或空对象兜底:
const values = Object.values(potentialData ?? {});
2. 稀疏数组(Sparse Array)中的空槽表现
如果将稀疏数组传给 Object.values(),由于未初始化的“空槽”(hole)并不属于数组自身存在的物理属性,它会被直接跳过;而显式赋值为 undefined 的元素则会被正常保留:
// 带有空槽的稀疏数组
const sparseArray = ["A", , "C"];
// 显式包含 undefined 的数组
const normalArray = ["A", undefined, "C"];
console.log(Object.values(sparseArray));
console.log(Object.values(normalArray));
七、方法选型决策与总结
为了帮助读者在不同业务需求下快速制定最佳方案,我们可以依据数据提取的诉求与边界条件归纳出以下决策路径:
总结而言,Object.values() 为现代 JavaScript 开发者提供了一种直观、高效且天然规避原型链污染的对象属性值收集方式。在绝大多数需要获取对象纯值的场景中,它都应当作为第一选择。熟练掌握其类型装箱机制、属性排序规则和过滤边界,能够帮助我们在面对各种复杂数据结构时写出更健壮、更具可读性的代码。
实用工具推荐
绿化、压缩、噪点和虚拟水印,自由调节做旧程度。
选择画质和输出格式,预览压缩前后的大小。