大网数据广告活动
Web 标准与前端开发

Object.getOwnPropertyDescriptor()

· 52CE 我爱测

**`Object.getOwnPropertyDescriptor()`** 静态方法返回一个对象,该对象描述给定对象上特定属性(即直接存在于对象上而不在对象的原型链中的属性)的配置。返回的对象是可变的,但对其进行更改不会影响原始属性的配置。

Object.getOwnPropertyDescriptor() 静态方法返回一个对象,该对象描述给定对象上特定属性(即直接存在于对象上而不在对象的原型链中的属性)的配置。返回的对象是可变的,但对其进行更改不会影响原始属性的配置。

JavaScript Demo: Object.getOwnPropertyDescriptor()

const object1 = {
  property1: 42,
};

const descriptor1 = Object.getOwnPropertyDescriptor(object1, "property1");

console.log(descriptor1.configurable);
// Expected output: true

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

语法

Object.getOwnPropertyDescriptor(obj, prop)

参数

  • obj
    • : 要查找其属性的对象。
  • prop
    • : 要检索其描述的属性的名称或 Symbol。

返回值

如果指定的属性存在于对象上,则返回其属性描述符,否则返回 undefined。

描述

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

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

  • value
    • : 与属性关联的值(仅限数据描述符)。
  • writable
    • : 当且仅当与属性关联的值可以更改时,为 true(仅限数据描述符)。
  • get
    • : 作为属性 getter 的函数,如果没有 getter 则为 undefined(仅限访问器描述符)。
  • set
    • : 作为属性 setter 的函数,如果没有 setter 则为 undefined(仅限访问器描述符)。
  • configurable
    • : 当且仅当此属性描述符的类型可以更改且该属性可以从相应对象中删除时,为 true。
  • enumerable
    • : 当且仅当此属性在相应对象的属性枚举中出现时,为 true。

示例

使用 Object.getOwnPropertyDescriptor()

let o, d;

o = {
  get foo() {
    return 17;
  },
};
d = Object.getOwnPropertyDescriptor(o, "foo");
console.log(d);
// {
//   configurable: true,
//   enumerable: true,
//   get: [Function: get foo],
//   set: undefined
// }

o = { bar: 42 };
d = Object.getOwnPropertyDescriptor(o, "bar");
console.log(d);
// {
//   configurable: true,
//   enumerable: true,
//   value: 42,
//   writable: true
// }

o = { [Symbol.for("baz")]: 73 };
d = Object.getOwnPropertyDescriptor(o, Symbol.for("baz"));
console.log(d);
// {
//   configurable: true,
//   enumerable: true,
//   value: 73,
//   writable: true
// }

o = {};
Object.defineProperty(o, "qux", {
  value: 8675309,
  writable: false,
  enumerable: false,
});
d = Object.getOwnPropertyDescriptor(o, "qux");
console.log(d);
// {
//   value: 8675309,
//   writable: false,
//   enumerable: false,
//   configurable: false
// }

非对象强制转换

在 ES5 中,如果该方法的第一个参数不是对象(而是一个基本类型值),则会导致 TypeError。在 ES2015 中,首先会将非对象的第一个参数强制转换为对象。

Object.getOwnPropertyDescriptor("foo", 0);
// TypeError: "foo" is not an object  // ES5 code

Object.getOwnPropertyDescriptor("foo", 0);
// Object returned by ES2015 code: {
//   configurable: false,
//   enumerable: true,
//   value: "f",
//   writable: false
// }

规范

浏览器兼容性

参见

  • Object.defineProperty()
  • Reflect.getOwnPropertyDescriptor()

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。