setter

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

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"]

語法

{set prop(val) { . . . }} {set [expression](val) { . . . }}

參數

prop: 要綁定到給定函式的屬性名。
val: 變數別名，該變數擁有要被嘗試安插到 prop 的數值。
expression: 從 ECMAScript 2015 開始，可以使用計算屬性名（computed property name）表達式，綁定到給定函式。

描述

JavaScript 的 setter 能在嘗試修改指定屬性時，執行給定函式。Setter 最常用於和 getter 一同建立虛擬屬性（pseudo-property）。你不可能給同一個屬性賦予 setter 與實際值。

使用 set 語法時，請注意以下情況：

可以擁有一個以數字或字串為代表的標示符；
最少要有一個參數（請參見 Incompatible ES5 change: literal getter and setter functions must now have exactly zero or one arguments 的詳細資料）；
不能以有另一個 set 的 object literal、或相同屬性入口（data entry）的 data 形式出現（不能使用 { set x(v) { }, set x(v) { } } and { x: ..., set x(v) { } }）

delete 操作符可移除 setter。

示例

在物件初始器的新物件定義 setter

這裡會給物件 language 定義稱為 current 的虛擬屬性。在指派數值時 log 會和該值一同更新：

var 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 is not defined and any attempts to access it will result in undefined.

使用 `delete` 操作符移除 setter

若想移除 setter 的話，可以直接使用 delete：

delete o.current;

針對已存在屬性的 setter 使用 `defineProperty`

To append a setter to an existing object later at any time, use Object.defineProperty().

var 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' property console.log(o.a); // 5

使用計算屬性名

var expr = "foo"; var obj = { baz: "bar", set [expr](v) { this.baz = v; }, }; console.log(obj.baz); // "bar" obj.foo = "baz"; // 跑 setter console.log(obj.baz); // "baz"

規範

Specification
ECMAScript® 2026 Language Specification # sec-method-definitions