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

Object.prototype.__defineSetter__()

· 52CE 我爱测

> [!NOTE] > 此特性已弃用,建议使用对象初始化语法或 Object.defineProperty() API 来定义 setter。该方法的行为只针对 Web 兼容性进行了规定,在任何平台上都不需要实现该方法。它可能无法在所有地方正常工作。

[!NOTE] 此特性已弃用,建议使用对象初始化语法或 Object.defineProperty() API 来定义 setter。该方法的行为只针对 Web 兼容性进行了规定,在任何平台上都不需要实现该方法。它可能无法在所有地方正常工作。

__defineSetter__() 方法将一个对象的属性绑定到一个函数上,当该属性被赋值时,该函数将被调用。

语法

__defineSetter__(prop, func)

参数

  • prop
    • : func 所绑定的 setter 函数所对应的属性名称,以字符串形式表示。
  • func
    • : 当试图设置指定属性时要调用的函数。该函数接收以下参数:
      • val
        • : 试图赋给 prop 的值。

返回值

undefined。

异常

  • TypeError
    • : 如果 func 不是函数,则抛出。

描述

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

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

示例

使用 __defineSetter__()

const o = {};
o.__defineSetter__("value", function (val) {
  this.anotherValue = val;
});
o.value = 5;
console.log(o.value); // undefined
console.log(o.anotherValue); // 5

以标准方式定义 setter 属性

在对象首次初始化时,你可以使用 set 语法来定义一个 setter。

const o = {
  set value(val) {
    this.anotherValue = val;
  },
};
o.value = 5;
console.log(o.value); // undefined
console.log(o.anotherValue); // 5

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

const o = {};
Object.defineProperty(o, "value", {
  set(val) {
    this.anotherValue = val;
  },
  configurable: true,
  enumerable: true,
});
o.value = 5;
console.log(o.value); // undefined
console.log(o.anotherValue); // 5

规范

浏览器兼容性

参见

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

资料来源与适用范围

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

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

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