Object.keys vs getOwnPropertyNames：遍历对象键名全解析

想精准控制对象键名的遍历范围？Object.keys 和 Object.getOwnPropertyNames 虽然都用于获取对象自身字符串键，但核心差异在于：前者仅返回可枚举属性（适合日常数据处理），后者则囊括所有自身字符串键（包括 toString、constructor 等不可枚举内置属性及手动设为 enumerable: false 的自定义属性），二者均不涉及 Symbol 键或原型链属性；真正全面的键名覆盖需组合 Object.keys、Object.getOwnPropertyNames 和 Object.getOwnPropertySymbols；理解这一区别，能帮你避免深拷贝遗漏、调试失察或元编程踩坑——选对方法，才是掌控对象结构的第一步。

Object.keys 和 Object.getOwnPropertyNames 都能获取对象的键名，但它们的行为有关键区别：前者只返回**可枚举属性**，后者返回**所有自身属性（包括不可枚举的）**。遍历键名时选哪个，取决于你是否需要访问如 toString、constructor 这类内置不可枚举属性，或你自己用 Object.defineProperty 设置的 enumerable: false 属性。

用 Object.keys 遍历可枚举键名

这是最常用的方式，适合日常开发中处理普通对象、JSON 数据、配置项等场景。它返回一个字符串数组，可直接配合 for...of、forEach 或展开运算符使用。

• 只包含对象自身的、且 enumerable === true 的属性
• 不包含原型链上的属性（如 hasOwnProperty）
• 不包含 Symbol 类型键（即使可枚举）

示例：

const obj = { a: 1, b: 2 };
Object.defineProperty(obj, 'hidden', { value: 3, enumerable: false });

console.log(Object.keys(obj)); // ['a', 'b']
for (const key of Object.keys(obj)) {
  console.log(key, obj[key]); // a 1 → b 2
}

用 Object.getOwnPropertyNames 遍历所有自身键名

当你需要完整查看对象“自己定义了哪些属性”，比如调试、序列化、深拷贝或实现属性白名单校验时，这个方法更全面。

• 返回所有自身属性键名（字符串），无论 enumerable 值是 true 还是 false
• 仍不包含 Symbol 键（要获取 Symbol 键需用 Object.getOwnPropertySymbols）
• 也不包含继承来的属性（如来自 Object.prototype）

示例：

const obj = { x: 10 };
Object.defineProperty(obj, 'y', { value: 20, enumerable: false });
Object.defineProperty(obj, 'z', { value: 30, enumerable: true });

console.log(Object.getOwnPropertyNames(obj)); // ['x', 'y', 'z']
// 可以访问到不可枚举的 'y'
obj.y; // 20

组合使用：覆盖全部自身键（含 Symbol）

如果真要拿到对象所有的自身键（字符串 + Symbol），需要把三个方法结果拼起来：

• Object.keys(obj)：可枚举字符串键
• Object.getOwnPropertyNames(obj)：所有字符串键（含不可枚举）
• Object.getOwnPropertySymbols(obj)：所有 Symbol 键（无论是否可枚举）

去重后即可得到完整键集合：

function getAllOwnKeys(obj) {
  const strings = Object.getOwnPropertyNames(obj);
  const symbols = Object.getOwnPropertySymbols(obj);
  return [...new Set([...strings, ...symbols])];
}

注意：都不能遍历原型链上的键

这两个方法都只作用于对象**自身**属性。如果你想包括原型链上的可枚举属性（比如自定义类的实例方法），得手动向上遍历：

• 用 for...in 循环可遍历自身 + 原型链上所有可枚举属性（需配合 hasOwnProperty 过滤）
• Object.keys 和 Object.getOwnPropertyNames 均不进入原型链

例如：

function Parent() {}
Parent.prototype.method = function() {};

const child = new Parent();
child.prop = 'own';

console.log(Object.keys(child)); // ['prop'] —— 不含 method
console.log('method' in child); // true —— method 在原型链上

到这里，我们也就讲完了《Object.keys vs getOwnPropertyNames：遍历对象键名全解析》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！