JavaScript | Object.getOwnPropertyDescriptors() 方法

Object.getOwnPropertyDescriptors() 方法是ES2017引入的一个用于获取对象所有属性的属性描述符（包括可枚举和不可枚举属性）的方法。它返回一个包含指定对象所有属性的属性描述符的对象。

语法

Object.getOwnPropertyDescriptors(obj)

其中：

• obj：必需，要获取属性描述符的对象。

返回值

该方法返回一个包含指定对象所有属性的属性描述符的对象。

例子

const person = {
  name: "John",
  age: 25,
  gender: "male"
}

const descriptors = Object.getOwnPropertyDescriptors(person)

console.log(descriptors)

输出结果如下：

{
  name: { value: "John", writable: true, enumerable: true, configurable: true },
  age: { value: 25, writable: true, enumerable: true, configurable: true },
  gender: { value: "male", writable: true, enumerable: true, configurable: true }
}

我们可以看到，Object.getOwnPropertyDescriptors() 方法返回了一个包含person对象所有属性的属性描述符的对象descriptors，每个属性的描述符对象包含value、writable、enumerable、configurable四个属性。

应用场景

Object.getOwnPropertyDescriptors() 方法可以用来实现对象的深拷贝（deep clone）。因为Object.assign() 方法在拷贝对象时默认会拷贝对象的可枚举属性，而不可枚举属性则不会拷贝。所以，如果要实现对象的深拷贝，需要使用Object.getOwnPropertyDescriptors() 方法获取对象的所有属性的描述符，再使用Object.create() 方法和该属性描述符来生成新的对象，从而实现对象的深拷贝。

下面是一个实现对象深拷贝的例子：

function deepClone(obj) {
  const descriptors = Object.getOwnPropertyDescriptors(obj)
  const cloneObj = Object.create(Object.getPrototypeOf(obj), descriptors)

  return cloneObj
}

const person = {
  name: "John",
  age: 25,
  gender: "male"
}

const clonedPerson = deepClone(person)

console.log(clonedPerson)

输出结果如下：

{
  name: "John",
  age: 25,
  gender: "male"
}

注意事项

• Object.getOwnPropertyDescriptors() 方法返回的属性描述符对象不包含get、set、value属性中的任意一个，而是包含了所有这三个属性的属性描述符。如果需要获取get、set、value属性中的任意一个，可以使用Object.getOwnPropertyDescriptor() 方法。

• Object.getOwnPropertyDescriptors() 方法不会返回原型链上的属性的属性描述符。如果需要获取原型链上的所有属性的属性描述符，可以使用Object.getPrototypeOf() 方法遍历原型链并使用Object.getOwnPropertyDescriptors() 或Object.getOwnPropertyDescriptor() 方法获取每个属性的属性描述符。

• Object.getOwnPropertyDescriptors() 方法返回的属性描述符对象不适用于通过Object.create() 或class 等方式创建的对象，因为这些对象没有自己的属性描述符。如果需要获取这些对象的属性描述符，需要使用Object.getPrototypeOf() 方法获取它们的原型对象的属性描述符。