Object.prototype.__lookupGetter__()

已弃用:此特性不再推荐。虽然某些浏览器可能仍然支持它,但它可能已经从相关的网络标准中删除,可能正在删除过程中,或者可能仅为兼容性目的而保留。请避免使用它,如果可能,请更新现有代码;请参阅本页底部的兼容性表格以指导您的决策。请注意,此特性可能随时停止工作。

注意:此功能已弃用,应优先使用 Object.getOwnPropertyDescriptor() API。此方法的行为仅为 Web 兼容性指定,并非平台必须实现。它可能无法在所有地方都正常工作。

__lookupGetter__() 方法用于 Object 实例,它返回绑定到指定属性的 getter 函数。

语法

js
__lookupGetter__(prop)

参数

prop

一个包含要返回其 getter 的属性名称的字符串。

返回值

绑定到指定属性的 getter 函数。如果找不到该属性,或者该属性是 数据属性,则返回 undefined

描述

所有继承自 Object.prototype 的对象(即除了 null-prototype 对象之外的所有对象)都继承了 __lookupGetter__() 方法。如果为对象的属性定义了 getter,则无法通过该属性引用 getter 函数,因为该属性会引用该函数的返回值。__lookupGetter__() 可用于获取对 getter 函数的引用。

__lookupGetter__() 会沿着 原型链 向上查找指定的属性。如果原型链上的任何对象拥有指定的 自有属性,则返回该属性的 属性描述符get 属性。如果该属性是数据属性,则返回 undefined。如果在整个原型链上都未找到该属性,也将返回 undefined

__lookupGetter__() 在规范中被定义为“规范可选”,这意味着没有实现是必须实现此功能的。然而,所有主流浏览器都实现了它,并且由于其持续的使用,不太可能被移除。如果浏览器实现了 __lookupGetter__(),它还需要实现 __lookupSetter__()__defineGetter__()__defineSetter__() 方法。

示例

使用 __lookupGetter__()

js
const obj = {
  get foo() {
    return Math.random() > 0.5 ? "foo" : "bar";
  },
};

obj.__lookupGetter__("foo");
// [Function: get foo]

以标准方式查找属性的 getter

您应该使用 Object.getOwnPropertyDescriptor() API 来查找属性的 getter。与 __lookupGetter__() 相比,此方法允许查找 Symbol 属性。Object.getOwnPropertyDescriptor() 方法也适用于 null-prototype 对象,这些对象不继承自 Object.prototype,因此没有 __lookupGetter__() 方法。如果 __lookupGetter__() 沿原型链查找的行为对您很重要,您可以使用 Object.getPrototypeOf() 自己实现它。

js
const obj = {
  get foo() {
    return Math.random() > 0.5 ? "foo" : "bar";
  },
};

Object.getOwnPropertyDescriptor(obj, "foo").get;
// [Function: get foo]
js
const obj2 = {
  __proto__: {
    get foo() {
      return Math.random() > 0.5 ? "foo" : "bar";
    },
  },
};

function findGetter(obj, prop) {
  while (obj) {
    const desc = Object.getOwnPropertyDescriptor(obj, prop);
    if (desc) {
      return desc.get;
    }
    obj = Object.getPrototypeOf(obj);
  }
}

console.log(findGetter(obj2, "foo")); // [Function: get foo]

规范

规范
ECMAScript® 2026 语言规范
# sec-object.prototype.__lookupGetter__

浏览器兼容性

另见