Object.entries返回一个二维数组,每个子元素为[key, value]形式的数组,仅包含对象自身可枚举、非Symbol的属性,不遍历原型链、不可枚举属性或Symbol键。

Object.entries 返回的是什么结构
Object.entries 直接返回一个二维数组,每个子项是 [key, value] 形式的数组。它不改变原对象,也不做深拷贝,只是提取可枚举自有属性的键值对。
注意:只遍历对象自身、可枚举(enumerable: true)、非 Symbol 的属性;继承属性、Symbol 键、不可枚举属性(如 Object.defineProperty 设置的 enumerable: false)都会被跳过。
常见错误现象:Object.entries({}) 返回空数组 [],但如果你看到 [["0","a"],["1","b"]],说明传入的是类数组(如字符串或伪数组),不是普通对象——这会导致后续 map 行为不符合预期。
用 map 遍历 Object.entries 结果的典型写法
返回值本身已是数组,可直接链式调用 map。关键在于解构参数时别漏掉括号:第一个参数是 [key, value],必须用数组解构语法接收。
- ✅ 正确:
Object.entries(obj).map(([k, v]) => `${k}: ${v}`) - ❌ 错误:
Object.entries(obj).map((k, v) => ...)—— 这里v实际是索引,不是值 - ⚠️ 注意:
map回调的第二个参数是当前索引,不是键值对里的 value;别和解构混淆
示例:
const user = { name: 'Alice', age: 30 };
Object.entries(user).map(([key, value]) => `${key}=${value}`);
// → ['name=Alice', 'age=30']
遇到 null 或 undefined 时会报错吗
会。Object.entries 只接受对象类型,传入 null 或 undefined 会抛出 TypeError: Cannot convert undefined or null to object。
安全做法是提前判断:
- 用
obj && typeof obj === 'object'做守卫 - 或用空对象兜底:
Object.entries(obj ?? {}).map(...) - 若需兼容类数组(如
arguments),应先用Array.from或扩展运算符转成真数组,而不是依赖Object.entries
性能提示:这个判断开销极小,但线上环境建议加上,尤其当对象来自 API 响应或用户输入时。
和 for...in + hasOwnProperty 对比有什么实际差异
Object.entries 更简洁、更函数式,且天然规避了 for...in 的两个经典坑:
- 不遍历原型链属性(
for...in默认会,需手动加hasOwnProperty判断) - 不遍历不可枚举属性(
for...in会跳过不可枚举属性,但行为不一致,比如Object.keys也不返回它们,而Object.getOwnPropertyNames会) - 返回结果顺序:ES2015+ 规定对象属性遍历顺序按「整数索引升序 → 其他字符串键插入顺序」,
Object.entries遵循该规则;for...in在旧引擎中顺序不可靠
但要注意:Object.entries 无法替代 Object.getOwnPropertyDescriptors 或 Reflect.ownKeys,因为它不包含不可枚举属性和 Symbol 键。
真正容易被忽略的是:如果对象有 getter 属性且没设置 enumerable: true,它不会出现在 Object.entries 结果里——这种场景下,你得确认业务是否真的只需要“可枚举”的键值对。











