使用Object.values快速获取JS对象的所有属性值

作者:纸飞机

时间:2026-11-21

浏览:646

深入讲解如何使用 JavaScript 原生方法 Object.values() 快速提取普通对象的所有自身属性值,涵盖规范运行机制、属性排序规则、可枚举过滤机制、实战场景及常见注意事项。

文章目录
ECMAScript 原生 API 阅读时长约 8 分钟 适用规范:ES2017+ (ES8)
使用Object.values快速获取JS对象的所有属性值
图 0:使用 Object.values() 将普通对象属性值一次性转出为纯值数组的整体效果概览
在 JavaScript 开发中,如果需要提取一个普通对象(Plain Object)自身的所有属性值并转化为有序数组,最标准且高效的原生方法是使用 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);
示例输出结果
[ "JavaScript 核心指南", 320, true ]

返回结果是纯净的一维数组,这意味着你可以立即无缝使用数组的所有原生高阶方法,例如 .map()、.filter()、.includes()、.reduce() 或展开运算符(Spread Operator)。

二、内部执行机制与值排序规则

很多开发者认为对象中的键值对是“无序”的,因而在使用 Object.values() 时会对数组元素的排列次序产生疑虑。根据 ECMAScript 规范定义,Object.values() 内部遵循严格的 EnumerableOwnPropertyNames 执行流程,元素的排列顺序具有确定性规范。

使用Object.values快速获取JS对象的所有属性值
图 1:Object.values() 从入参校验、属性键提取、顺序判定到数组输出的执行流水线

从底层机制来看,Object.values(obj) 的执行会经历四个核心阶段:

  1. 类型装箱(ToObject):如果传入的是原始基本类型(例如字符串、数值、布尔值),JavaScript 会先将其包装成对应的对象实体;如果传入 null 或 undefined,规范规定直接抛出 TypeError 异常。
  2. 确定自身可枚举键的排列顺序:提取属性时,属性键严格按照以下次序依次排布:
    • 非负整数索引键:按照数值大小升序排列(例如 1, 2, 10 会排在前面且按由小到大排列);
    • 常规字符串键:按照属性被创建或插入的先后顺序紧随其后;
    • Symbol 类型键:在此阶段被完全忽略,不进入列表。
  3. 可枚举性双重过滤:引擎逐一核对属性描述符(Property Descriptor),仅保留满足 enumerable: true 且属于对象自身(Own Property)的属性。
  4. 读取值并生成数组:引擎依次根据排序后的键名获取属性值,组装并返回一个崭新的数组实例。

我们可以通过一段具体的混合键顺序示例来观察这一规律:

const mixedObj = {
  "b": "字母 B",
  2: "数字二",
  "a": "字母 A",
  1: "数字一"
};

const result = Object.values(mixedObj);
console.log(result);
示例输出结果
[ "数字一", "数字二", "字母 B", "字母 A" ]

从结果可以看到,尽管在代码声明时 "b" 写在最前面,但整数键 1 和 2 被优先按升序排在了前面,随后才是按书写顺序出现的 "b" 与 "a"。这种排序规则保证了与 Object.keys() 以及 for...in 在规范层面的一致性。

三、属性提取规则与边界对照

明确 Object.values() 到底会提取哪些属性、忽略哪些属性,是避免业务中产生隐蔽 Bug 的关键。

使用Object.values快速获取JS对象的所有属性值
图 2:四种不同属性在 Object.values() 遍历中的保留与忽略对照

在 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));
示例输出结果
[ true, 42 ]

可以看到,继承的 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} 元`);
示例输出结果
本月总支出: 6070 元

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);
示例输出结果
表单整体就绪: false 是否存在错误: true

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);
示例输出结果
[ { code: "DRAFT", label: "草稿待审" }, { code: "PENDING", label: "审批处理中" }, { code: "APPROVED", label: "已批准发布" } ]

4. 快速搜索或判断特定数值是否存在

当无需知道属性键,只需判断某个具体值是否隶属于该实体时,结合 .includes() 是最简洁的书写方式:

const rolePermissions = {
  editor: "WRITE_POST",
  admin: "MANAGE_USERS",
  auditor: "VIEW_LOGS"
};

const canManageUsers = Object.values(rolePermissions).includes("MANAGE_USERS");
console.log("系统包含管理用户权限:", canManageUsers);
示例输出结果
系统包含管理用户权限: true

五、Object 反射方法对比与协作

Object.values() 并不是孤立存在的,它与 ES5 的 Object.keys() 以及 ES8 的 Object.entries() 共同构成了现代 JavaScript 对象反射的三大支柱。

使用Object.values快速获取JS对象的所有属性值
图 3:ES8 对象反射三大核心方法与传统 for...in 循环的结构形态对照

在具体开发中,开发者应当根据当前任务的最小信息集原则进行选型:

  • 仅关注内容/值:选用 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"));
// 字符串转为各个单字符构成的数组
示例输出结果
[ "H", "e", "l", "l", "o" ]

当传入数值或布尔值时,包装对象自身没有任何可枚举属性,因此会安全地返回空数组,不会报错:

console.log(Object.values(12345)); // 输出 []
console.log(Object.values(true));  // 输出 []
示例输出结果
[] []
⚠️ 必错避坑:null 与 undefined 参数

与数值不同,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));
示例输出结果
[ "A", "C" ] [ "A", undefined, "C" ]

七、方法选型决策与总结

为了帮助读者在不同业务需求下快速制定最佳方案,我们可以依据数据提取的诉求与边界条件归纳出以下决策路径:

使用Object.values快速获取JS对象的所有属性值
图 4:JavaScript 对象提取操作选型决策树与边界应对路径

总结而言,Object.values() 为现代 JavaScript 开发者提供了一种直观、高效且天然规避原型链污染的对象属性值收集方式。在绝大多数需要获取对象纯值的场景中,它都应当作为第一选择。熟练掌握其类型装箱机制、属性排序规则和过滤边界,能够帮助我们在面对各种复杂数据结构时写出更健壮、更具可读性的代码。

实用工具推荐

电子包浆

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

使用 ›
图片压缩

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

使用 ›
相关文章