Object.prototype.__defineGetter__()

语法

__defineGetter__(prop, func)

参数

prop

func 所绑定的 getter 函数所对应的属性名称，以字符串形式表示。

func

绑定到指定属性查询的函数。

返回值

undefined。

异常

TypeError

如果 func 不是函数，则抛出。

描述

所有继承自 Object.prototype 的对象（也就是除了 null 原型对象的对象）都会继承 __defineGetter__() 方法。该方法允许在一个已存在的对象上定义一个 getter。这相当于使用 Object.defineProperty(obj, prop, { get: func, configurable: true, enumerable: true }) 方法，这意味着该属性是可枚举和可配置的，而且如果存在，则保留任何现有的 setter。

__defineGetter__() 在规范中被定义为“可选规范”，这意味着不需要任何实现来实现它。然而，所有主要的浏览器都实现了它，并且由于它的持续使用，它不太可能被删除。如果一个浏览器实现了 __defineGetter__()，那么它还需要实现 __lookupGetter__()、__lookupSetter__() 和 __defineSetter__() 方法。

示例

使用 __defineGetter__()

const o = {};
o.__defineGetter__("gimmeFive", function () {
  return 5;
});
console.log(o.gimmeFive); // 5

以标准方式定义 getter 属性

在对象首次初始化时，你可以使用 get 语法来定义一个 getter。

const o = {
  get gimmeFive() {
    return 5;
  },
};
console.log(o.gimmeFive); // 5

你也可以使用 Object.defineProperty() 在对象创建后为其定义一个 getter。与 __defineGetter__() 相比，此方法允许你控制 getter 的可枚举性和可配置性，以及定义 Symbol 属性。Object.defineProperty() 方法也适用于 null 原型对象，因为他们没有继承 Object.prototype，所以没有 __defineGetter__() 方法。

const o = {};
Object.defineProperty(o, "gimmeFive", {
  get() {
    return 5;
  },
  configurable: true,
  enumerable: true,
});
console.log(o.gimmeFive); // 5

规范

浏览器兼容性

参见

• core-js 中 Object.prototype.__defineGetter__ 的 polyfill
• Object.prototype.__defineSetter__()
• get 语法
• Object.defineProperty()
• Object.prototype.__lookupGetter__()
• Object.prototype.__lookupSetter__()
• JS 指南：定义 Getter 和 Setter
• [博文] __defineGetter__ 和 __defineSetter__ 已被弃用
• Firefox bug 647423