set

オブジェクトプロパティに対して、値を設定しようとするときに呼び出される関数を割り当てます。

構文

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

引数

prop

与えられた関数を割り当てるプロパティの名称です。

val

prop に設定しようとする値を保持する変数のエイリアスです。

説明

JavaScript では、特定のプロパティを変更しようとするたびに関数を実行するため、setter を利用できます。setter はたいてい getter と合わせて、擬似的なプロパティを作成するために用いられます。実際の値を持つプロパティが、同時に setter を持つことはできません。

setter は delete 演算子を用いて削除できます。

例

set 演算子による setter の定義

ここではオブジェクト o に疑似プロパティ current を定義して、値が設定されたときに log をその値で更新します:

var o = {
  set current (str) {
    return this.log[this.log.length] = str;
  },
  log: []
}

current は定義されておらず、あらゆるアクセスを試みてもその結果は undefined になることに注意してください。

delete 演算子による setter の削除

delete o.current;

ブラウザ実装状況

Robert Nyman's page に基づきます。

サポートなし (特に IE6-8 において) とは、スクリプトが構文エラーになることを意味します。