Object.prototype.defineSetter()

¥Syntax

__defineSetter__(prop, func)

¥Parameters

prop

包含 setter func 绑定到的属性名称的字符串。

func

尝试设置指定属性时调用的函数。该函数接收以下参数：

val

该值尝试分配给 prop。

¥Return value

无 (undefined)。

¥None (undefined).

¥Exceptions

TypeError

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

¥Description

所有从 Object.prototype 继承的对象（即除 null-原型对象 之外的所有对象）都继承 __defineSetter__() 方法。此方法允许在预先存在的对象上定义 setter。这相当于 Object.defineProperty(obj, prop, { set: func, configurable: true, enumerable: true })，这意味着该属性是可枚举和可配置的，并且任何现有的 getter（如果存在）都会被保留。

¥All objects that inherit from Object.prototype (that is, all except null-prototype objects) inherit the __defineSetter__() method. This method allows a setter to be defined on a pre-existing object. This is equivalent to Object.defineProperty(obj, prop, { set: func, configurable: true, enumerable: true }), which means the property is enumerable and configurable, and any existing getter, if present, is preserved.

__defineSetter__() 在规范中定义为 "规范性 可选性"，这意味着不需要实现即可实现此目的。然而，所有主流浏览器都实现了它，并且由于它的持续使用，它不太可能被删除。如果浏览器实现了 __defineSetter__()，它还需要实现 __lookupGetter__()、__lookupSetter__() 和 __defineGetter__() 方法。

¥__defineSetter__() is defined in the spec as "normative optional", which means no implementation is required to implement this. However, all major browsers implement it, and due to its continued usage, it's unlikely to be removed. If a browser implements __defineSetter__(), it also needs to implement the __lookupGetter__(), __lookupSetter__(), and __defineGetter__() methods.

¥Examples

¥Using __defineSetter__()

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

¥Defining a setter property in standard ways

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

¥You can use the set syntax to define a setter when the object is first initialized.

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-原型对象，null-原型对象 不是从 Object.prototype 继承的，因此没有 __defineSetter__() 方法。

¥You may also use Object.defineProperty() to define a setter on an object after it's been created. Compared to __defineSetter__(), this method allows you to control the setter's enumerability and configurability, as well as defining symbol properties. The Object.defineProperty() method also works with null-prototype objects, which don't inherit from Object.prototype and therefore don't have the __defineSetter__() method.

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

¥See also

• core-js 中 Object.prototype.__defineSetter__ 的 Polyfill
• Object.prototype.__defineGetter__()
• set
• Object.defineProperty()
• Object.prototype.__lookupGetter__()
• Object.prototype.__lookupSetter__()
• JS 指南：定义 Getter 和 Setter
• 火狐浏览器错误 647423