JavaScript 判断对象是否包含某个属性

在JavaScript中，有多种方式可以判断对象是否包含某个属性。每种方式都有其特定的使用场景和局限性。
若是要查看属性分类可以查看以下两篇文章：

• JavaScript 对象属性分类详解
• JavaScript ES6中的class属性详解

1. in 操作符（推荐）

const obj = {
  name: 'Alice',
  age: undefined
};

Object.defineProperty(obj, 'hidden', {
  value: 'secret',
  enumerable: false
});

// 使用 in 操作符
console.log('name' in obj);     // true
console.log('age' in obj);      // true (即使值为undefined)
console.log('hidden' in obj);   // true (不可枚举属性)
console.log('toString' in obj); // true (原型链属性)
// 是 in 操作符的函数式替代，与in功能完全一致
console.log(Reflect.has(obj, 'name')); // true

特点：

• 检测对象自身和原型链上的所有属性
• 能正确处理值为 undefined 的属性
• 能检测不可枚举属性
• 最全面的检测方式

2. for…in遍历

const obj = {
  name: 'Alice',
  age: undefined
};

Object.defineProperty(obj, 'hidden', {
  value: 'secret',
  enumerable: false
});

for (let key in obj) {
  console.log(key);
}
// 输出：
// name
// age
// （不会输出 'hidden'）

特点：

• for...in 用于遍历对象自身和原型链上的的可枚举属性。
• 跳过自身和原型链上的不可枚举属性。
• in操作符是存在就遍历，for...in则是可枚举就遍历。

3. hasOwnProperty() 方法

const obj = {
  name: 'Alice',
  age: undefined
};

Object.defineProperty(obj, 'hidden', {
  value: 'secret',
  enumerable: false
});

// 使用 hasOwnProperty
console.log(obj.hasOwnProperty('name'));     // true
console.log(obj.hasOwnProperty('age'));      // true
console.log(obj.hasOwnProperty('hidden'));   // true
console.log(obj.hasOwnProperty('toString')); // false (不检测原型链)

特点：

• 只检测对象自身的属性
• 不检测原型链上的属性
• 能正确处理值为 undefined 的属性
• 能检测不可枚举属性

4. Object.hasOwn() 方法（ES2022）

const obj = {
  name: 'Alice',
  age: undefined
};

// 使用 Object.hasOwn()
console.log(Object.hasOwn(obj, 'name'));     // true
console.log(Object.hasOwn(obj, 'age'));      // true
console.log(Object.hasOwn(obj, 'toString')); // false

特点：

• ES2022新增方法，是 hasOwnProperty 的安全替代
• 不会因为重写 hasOwnProperty 而出错
• 只检测对象自身的属性

5. property in object !== undefined

const obj = {
  name: 'Alice',
  age: undefined
};

// 通过属性值判断
console.log(obj.name !== undefined); // true
console.log(obj.age !== undefined);  // false (错误!)
console.log(obj.gender !== undefined); // false

特点：

• 通过检查属性值是否为 undefined 来判断
• 当属性值本身就是 undefined 时会误判
• 不推荐使用

6. Object.keys().includes()

const obj = {
  name: 'Alice',
  age: 25
};

Object.defineProperty(obj, 'hidden', {
  value: 'secret',
  enumerable: false
});

// 使用 Object.keys
console.log(Object.keys(obj).includes('name'));   // true
console.log(Object.keys(obj).includes('hidden')); // false (不可枚举属性)

特点：

• 只返回可枚举的自身属性
• 不检测不可枚举属性
• 不检测原型链属性

7. Object.getOwnPropertyNames()

const obj = {
  name: 'Alice'
};

Object.defineProperty(obj, 'hidden', {
  value: 'secret',
  enumerable: false
});

// 使用 Object.getOwnPropertyNames
console.log(Object.getOwnPropertyNames(obj).includes('name'));   // true
console.log(Object.getOwnPropertyNames(obj).includes('hidden')); // true
console.log(Object.getOwnPropertyNames(obj).includes('toString')); // false

特点：

• 返回所有自身属性（包括不可枚举）
• 不检测原型链属性

对比表格

实际应用示例

// 1. 检测配置对象中的可选属性
function processConfig(config) {
  if ('theme' in config) {
    // 处理主题配置，即使 theme: undefined 也算配置了
  }
  
  if (Object.hasOwn(config, 'timeout')) {
    // 只处理自身配置的超时时间
  }
}

// 2. 遍历对象属性时的安全检查
function safeIterate(obj) {
  for (const key in obj) {
    if (obj.hasOwnProperty(key)) { // 或 Object.hasOwn(obj, key)
      console.log(key, obj[key]);
    }
  }
}

// 3. 深度克隆时的属性检测
function deepClone(obj) {
  if (obj === null || typeof obj !== 'object') return obj;
  
  const cloned = Array.isArray(obj) ? [] : {};
  
  for (const key in obj) {
    if (Object.hasOwn(obj, key)) {
      cloned[key] = deepClone(obj[key]);
    }
  }
  
  return cloned;
}

最佳实践建议

1. 全面检测：使用 in 操作符
2. 检测自身及原型链上的可枚举属性：使用for...in遍历
3. 检测自身属性：使用 Object.hasOwn()（推荐）或 hasOwnProperty()
4. 检测可枚举属性：使用 Object.keys()
5. 避免值判断：不要使用 !== undefined 判断属性存在性
6. 现代项目：优先使用 Object.hasOwn() 替代 hasOwnProperty()

选择合适的方法取决于具体的使用场景和需求。