此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。
setter
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2015年7月.
当尝试设置属性时，set 语法将对象属性绑定到要调用的函数。它还可以在类中应用。
尝试一下
const language = { set current(name) { this.log.push(name); }, log: [],};language.current = "EN";language.current = "FA";console.log(language.log);// Expected output: Array ["EN", "FA"]语法
js
{ set prop(val) { /* … */ } }{ set [expression](val) { /* … */ } }参数
描述
在 javascript 中，如果试着改变一个属性的值，那么对应的 setter 将被执行。setter 经常和 getter 连用以创建一个伪属性。不可能在具有真实值的属性上同时拥有一个 setter 器。
使用 set 语法时请注意：
- 它的标识符可以是数字或字符串；
- 它必须有一个明确的参数（详见Incompatible ES5 change: literal getter and setter functions must now have exactly zero or one arguments）；
- 在对象字面量中，不能为一个已有真实值的变量使用 set，也不能为一个属性设置多个 set。(
{ set x(v) { }, set x(v) { } }和{ x: ..., set x(v) { } }是不允许的 )
示例
在对象初始化时定义 setter
这将定义一个对象language 的伪属性current，当current被分配一个值时，将使用该值更新log：
js
const language = { set current(name) { this.log.push(name); }, log: [],};language.current = "EN";console.log(language.log); // ['EN']language.current = "FA";console.log(language.log); // ['EN', 'FA']请注意，current属性是未定义的，访问它时将会返回undefined。
用delete 操作符移除一个 setter
我们可以使用delete操作符移除 setter。
js
delete language.current;使用defineProperty 为当前对象定义 setter
我们可以随时使用Object.defineProperty() 给一个已经存在的对象添加一个 setter。
js
const o = { a: 0 };Object.defineProperty(o, "b", { set: function (x) { this.a = x / 2; },});o.b = 10; // Runs the setter, which assigns 10 / 2 (5) to the 'a' propertyconsole.log(o.a); // 5使用计算属性名
js
const expr = "foo";const obj = { baz: "bar", set [expr](v) { this.baz = v; },};console.log(obj.baz); // "bar"obj.foo = "baz"; // run the setterconsole.log(obj.baz); // "baz"规范
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-method-definitions |