object.values() 返回对象所有可枚举自身属性值的数组,按数字键升序、其余键定义顺序排列;不包含原型链和不可枚举属性;参数为非对象时会强制转换;es2017引入,兼容性需注意。

Object.values() 是 JavaScript 中用于获取对象所有可枚举自身属性值的内置方法,返回一个由这些值组成的数组,顺序与 for...in 循环一致(即按属性定义顺序,对数字键会自动排序)。
基本用法和返回结果
它只遍历对象自身的、可枚举的属性,不包括原型链上的属性,也不包括不可枚举属性(如通过 Object.defineProperty 设置 enumerable: false 的属性)。
- 参数必须是对象(原始值会被强制转换为对应包装对象,如字符串转为 String 实例)
- 返回的是浅拷贝的数组,修改该数组不影响原对象
- 值的顺序:数字键按升序排在前面,其余键按定义顺序排列
例如:
const obj = { a: 'hello', 2: 'two', 1: 'one', b: 'world' };console.log(Object.values(obj)); // ['one', 'two', 'hello', 'world']
处理特殊情况的行为
了解边界情况有助于避免意外结果:
- 空对象返回空数组:
Object.values({}) // [] - 传入 null 或 undefined 会抛出 TypeError
- 传入数组时,把数组当对象处理,索引作为键:
Object.values([10, 20]) // [10, 20] - 传入字符串时,按字符索引取值:
Object.values('ab') // ['a', 'b'] - Symbol 键也会被包含(只要可枚举):
const s = Symbol('key'); Object.values({[s]: 42}) // [42]
与 Object.keys() 和 Object.entries() 的配合使用
这三个方法常一起使用,实现对象的遍历或转换:
- 快速提取所有值并做处理:
Object.values(obj).map(x => x * 2) - 结合 keys 获取键值对映射:
Object.keys(obj).map(key => [key, obj[key]])(等价于Object.entries(obj)) - 筛选值:
Object.values(obj).filter(v => typeof v === 'string')
注意:如果需要包含不可枚举属性或原型属性,需配合 Object.getOwnPropertyNames() 或 Reflect.ownKeys() 手动取值。
兼容性与替代方案
Object.values() 在 ES2017 中正式引入,现代浏览器和 Node.js(v7.0+)均支持。若需兼容旧环境:
- 使用 Babel 转译(推荐)
- 手动实现(仅适用于简单对象):
function values(obj) { return Object.keys(obj).map(key => obj[key]); } - 注意:手动实现无法正确处理不可枚举属性或原型属性,也不支持 Symbol 键(除非额外处理)
不复杂但容易忽略细节。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











