此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。

View in English Always switch to English

Object.getOwnPropertyDescriptors()

基线 广泛可用

自 2017年4月 起,此特性已在主流浏览器中得到支持,可在大多数设备和浏览器版本中正常使用。

Object.getOwnPropertyDescriptors() 静态方法返回给定对象的所有自有属性描述符。

尝试一下

const object1 = {
  property1: 42,
};

const descriptors1 = Object.getOwnPropertyDescriptors(object1);

console.log(descriptors1.property1.writable);
// Expected output: true

console.log(descriptors1.property1.value);
// Expected output: 42

语法

js
Object.getOwnPropertyDescriptors(obj)

参数

obj

要获取其所有自有属性描述符的对象。

返回值

一个包含给定对象的所有自有属性描述符的对象。如果没有属性,则可能是一个空对象。

描述

该方法允许查看对象的所有自有属性的精确描述。在 JavaScript 中,一个属性由一个字符串值的名称或一个 Symbol 和一个属性描述符组成。关于属性描述符类型及其特性的更多信息可以在 Object.defineProperty() 中找到。

一个属性描述符是一个记录,具有以下一些特性:

value

与属性关联的值(仅限数据描述符)。

writable

当且仅当与属性关联的值可以更改时,为 true(仅限数据描述符)。

get

作为属性 getter 的函数,如果没有 getter 则为 undefined(仅限访问器描述符)。

set

作为属性 setter 的函数,如果没有 setter 则为 undefined(仅限访问器描述符)。

configurable

当且仅当此属性描述符的类型可以更改且该属性可以从相应对象中删除时,为 true

enumerable

当且仅当此属性在相应对象的属性枚举中出现时,为 true

示例

浅拷贝一个对象

Object.assign() 方法仅将可枚举的自有属性从源对象复制到目标对象,你可��使用此方法和 Object.create() 方法对两个未知对象进行浅拷贝

js
Object.create(
  Object.getPrototypeOf(obj),
  Object.getOwnPropertyDescriptors(obj),
);

创建子类

创建子类的典型方法是定义子类,将其原型设置为超类的实例,然后在该实例上定义属性。这么写很不优雅,特别是对于 getter 和 setter 而言。相反,你可以使用此代码设置原型:

js
function superclass() {}
superclass.prototype = {
  // 在这里定义超类的构造方法、方法和属性
};
function subclass() {}
subclass.prototype = Object.create(superclass.prototype, {
  // 在这里定义子类的构造方法、方法和属性
});

规范

规范
ECMAScript® 2027 Language Specification
# sec-object.getownpropertydescriptors

浏览器兼容性

参见