The set syntax binds an object property to a function to be called when there is an attempt to set that property.


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


The name of the property to bind to the given function.
An alias for the variable that holds the value attempted to be assigned to prop.
Starting with ECMAScript 2015, you can also use expressions for a computed property name to bind to the given function.


In JavaScript, a setter can be used to execute a function whenever a specified property is attempted to be changed. Setters are most often used in conjunction with getters to create a type of pseudo-property. It is not possible to simultaneously have a setter on a property that holds an actual value.

Note the following when working with the set syntax:

A setter can be removed using the delete operator.


Defining a setter on new objects in object initializers

This will define a pseudo-property current of object language that, when assigned a value, will update log with that value:

var language = {
  set current(name) {
  log: []

language.current = 'EN';
console.log(language.log); // ['EN']

language.current = 'FA';
console.log(language.log); // ['EN', 'FA']

Note that current is not defined and any attempts to access it will result in undefined.

Removing a setter with the delete operator

If you want to remove the setter, you can just delete it:

delete o.current;

Defining a setter on existing objects using 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

Using a computed property name

var expr = 'foo';

var obj = {
  baz: 'bar',
  set [expr](v) { this.baz = v; }

console.log(obj.baz); // "bar"
obj.foo = 'baz';      // run the setter
console.log(obj.baz); // "baz"


Browser compatibilityUpdate compatibility data on GitHub

Chrome Edge Firefox Internet Explorer Opera Safari
Basic support 1 Yes 2 9 9.5 3
Computed property names 46 Yes 34 No 47 No
Android webview Chrome for Android Edge Mobile Firefox for Android Opera for Android iOS Safari Samsung Internet
Basic support 1 18 Yes 4 Yes Yes Yes
Computed property names 46 46 Yes 34 Yes No 5.0
Basic support Yes
Computed property names Yes

See also

© 2005–2018 Mozilla Developer Network and individual contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.