JavaScript怎么只遍历对象自身属性而排除原型链

在 JavaScript 中，只遍历对象自身的属性并排除原型链上的继承属性，最简单且符合现代标准的方法是使用 Object.keys()、Object.values() 或 Object.entries() 配合循环结构。这些方法天然只提取对象自身的可枚举属性，完全不触碰原型链。如果由于兼容性或历史代码维护必须使用 for...in 循环，则必须在循环体内部搭配 Object.hasOwn(obj, key) 进行显式守卫过滤。

一、为什么常规遍历会受到原型链属性的干扰？

JavaScript 采用原型链继承机制。传统的 for...in 语句在设计初期的行为规范是：遍历对象的所有可枚举属性（enumerable properties）。这个查找过程并不会在对象自身终止，而是沿着 [[Prototype]] 原型链自底向上持续查找，直到终点 null。

当第三方库、老旧项目脚本或者不可控的业务代码向公共原型（如 Object.prototype 或自定义构造函数的 prototype）添加自定义属性或方法时，若未将其配置为不可枚举（enumerable: false），这些属性就会全部出现在 for...in 的循环变量中，直接导致意外赋值、数据校验失败或不可预期的逻辑崩溃。

// 原型链属性受污染的典型示例
function Animal(name) {
  this.name = name; // 自身属性
}
// 原型上添加了一个可枚举属性
Animal.prototype.species = "vertebrate";

const cat = new Animal("Tom");

// 直接使用 for...in 遍历：
for (const key in cat) {
  console.log(key); // 输出: "name"，紧接着输出原型的 "species"
}

二、现代首选方案：使用 Object 原生静态方法

ECMAScript 5 与 ECMAScript 2017 先后引入的 Object.keys()、Object.values() 与 Object.entries() 是解决该问题的最直接途径。规范明确规定：这三个方法只返回对象自身（own）且为可枚举（enumerable）的字符串键对应的数据，完全不沿着原型链向上搜索。

1. 仅需要属性键：Object.keys(obj)

Object.keys() 返回一个由对象自身所有可枚举属性名组成的普通数组。可以直接使用 for...of、forEach 或常规数组方法进行迭代：

const user = {
  id: 101,
  username: "alex"
};
Object.prototype.globalTheme = "dark"; // 模拟原型污染

// 只遍历自身属性键
for (const key of Object.keys(user)) {
  console.log(`键: ${key}, 值: ${user[key]}`);
}
// 实际输出:
// 键: id, 值: 101
// 键: username, 值: alex
// (完全不会输出 globalTheme)

2. 同时需要属性键和属性值：Object.entries(obj)

如果同时需要处理键名和键值，Object.entries() 是代码表达最为优雅的选择。它返回一个二维数组 [[key1, value1], [key2, value2]]，配合数组解构语法，免去了每次都通过下标 obj[key] 二次寻值的开销：

for (const [key, value] of Object.entries(user)) {
  console.log(`${key} -> ${value}`);
}

三、传统方案：for...in 循环结合显式条件过滤

如果工程需要兼容更早期的运行环境，或者在特定场景下依然选用 for...in 语句，则必须在循环内部进行自身属性判定。

1. 现代标准推荐：Object.hasOwn(obj, key)

ECMAScript 2022（ES13）正式引入了 Object.hasOwn() 静态方法，专门用于替代老旧脆弱的 Object.prototype.hasOwnProperty 实例调用：

const profile = {
  nickname: "Coder",
  level: 5
};
Object.prototype.inheritedFlag = true;

for (const key in profile) {
  // 使用 Object.hasOwn 进行属性归属校验
  if (Object.hasOwn(profile, key)) {
    console.log(`有效自身属性: ${key} = ${profile[key]}`);
  }
}
// 仅输出:
// 有效自身属性: nickname = Coder
// 有效自身属性: level = 5

2. 为什么严禁直接使用 obj.hasOwnProperty(key)？

在以往很多教程中，常看到 if (obj.hasOwnProperty(key)) 的写法。这种写法在实际生产中有两个致命缺陷：

• 原型为 null 的对象会抛出异常：通过 Object.create(null) 创建的纯净字典对象没有原型链，也就根本没有 hasOwnProperty 方法，直接调用会触发 TypeError: obj.hasOwnProperty is not a function。
• 对象自身可能遮蔽同名属性：如果对象本身有一个名为 hasOwnProperty 的键（例如从后端解析的 JSON { "hasOwnProperty": false, "name": "test" }），直接调用会导致该方法被遮蔽甚至报错。

四、进阶边界场景：Symbol 键与不可枚举属性

在处理复杂对象或者底层框架开发时，除了常规的字符串可枚举属性外，还会涉及 Symbol 属性 和 不可枚举属性。上述的 Object.keys() 和 for...in 均无法捕获这两类属性。

1. 需要遍历自身的 Symbol 键

Symbol 常用于作为私有标识符或内部状态存储。如果需要遍历对象自身的 Symbol 属性，可以使用 Object.getOwnPropertySymbols(obj)：

const idSym = Symbol("id");
const data = {
  [idSym]: 999,
  title: "config"
};

// 获取自身所有的 Symbol 键
const symKeys = Object.getOwnPropertySymbols(data);
console.log(symKeys); // [ Symbol(id) ]

2. 获取对象自身的所有键（含不可枚举与 Symbol）：Reflect.ownKeys(obj)

如果需求是彻底获取对象自身的一切属性（无论是否可枚举、无论是 String 还是 Symbol），且同样严格排除原型链，最完备的 API 是 Reflect.ownKeys(obj)：

const allOwnKeys = Reflect.ownKeys(data);
// 返回: ['title', Symbol(id)] （完全不包含任何原型链上的属性）

五、综合选型与总结对比

为了在实际开发中准确选用最合适的方法，下表汇总了 JavaScript 中常见的对象属性遍历 API 在各维度下的支持情况：

总结而言，在日常业务开发中，直接使用 Object.entries() 或 Object.keys() 配合 for...of 是最安全、最具可读性且无需额外逻辑判断的标准方案；唯有在需要向下兼容旧版环境而沿用 for...in 时，务必通过 Object.hasOwn(obj, key) 或 Object.prototype.hasOwnProperty.call(obj, key) 将原型链上的属性彻底过滤。