セッター
BaselineWidely 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"]構文
js
{set prop(val) { . . . }}{set [expression](val) { . . . }}引数
prop与えられた関数を割り当てるプロパティの名称です。
valpropに設定しようとする値を保持する変数のエイリアスです。expressionECMAScript 2015 より、算出されたプロパティ名 (computed property name) の式を使用して関数に結び付けることもできます。
解説
JavaScript では、セッターは指定されたプロパティを変更しようとするたびに関数を実行するために使用されます。セッターはゲッターと組み合わせて、一種の擬似的なプロパティを作成するために、とてもよく使われます。実際の値を保持するプロパティに、同時にセッターを設定することはできません。
なお、set 構文を使用する際の注意事項は次の通りです。
- 識別子は数値でも文字列でも持つことができます。
- 厳密に 1 つの引数を持たなければなりません（詳しくはIncompatible ES5 change: literal getter and setter functions must now have exactly zero or one arguments をご覧ください）。
- あるオブジェクトリテラルが、同じプロパティのための別の
setを持ったり、データ項目を持ったりしてはいけません。（{ set x(v) { }, set x(v) { } }や{ x: ..., set x(v) { } }は不可）
例
新しいオブジェクトでオブジェクトの初期化時にセッターを定義
以下の例では、擬似プロパティcurrent をlanguage オブジェクトに定義します。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 演算子によるセッターの削除
セッターを削除したい場合は、delete だけで削除できます。
js
delete language.current;defineProperty を使用して既存のオブジェクトにセッターを定義
既存のオブジェクトにセッターを追加するには、Object.defineProperty() を使用します。
js
const o = { a: 0 };Object.defineProperty(o, "b", { set: function (x) { this.a = x / 2; },});o.b = 10;// セッターを実行し、 10 / 2 (5) を 'a' プロパティに代入console.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";// セッターを実行console.log(obj.baz);// "baz"仕様書
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-method-definitions |