Object.prototype.defineSetter()

Warning: This feature is deprecated in favor of defining setters using the object initializer syntax or the Object.defineProperty() API.

However, as it is widely implemented and used on the Web, it is very unlikely that browsers will stop implementing it.

The __defineSetter__ method binds an object's property to a function to be called when an attempt is made to set that property.

Syntax

__defineSetter__(prop, fun)

Parameters

prop

A string containing the name of the property to be bound to the given function.

fun

A function to be called when there is an attempt to set the specified property. This function takes the form

    function(val) { . . . }
    ```

- `val`
  - : An alias for the variable that holds the value attempted to be assigned to
    `prop`.

Return value

undefined.

Description

The __defineSetter__ method allows a setter to be defined on a pre-existing object.

Examples

Non-standard and deprecated way

var o = {};
o.__defineSetter__('value', function(val) { this.anotherValue = val; });
o.value = 5;
console.log(o.value); // undefined
console.log(o.anotherValue); // 5

Standard-compliant ways

// Using the set operator
var o = { set value(val) { this.anotherValue = val; } };
o.value = 5;
console.log(o.value); // undefined
console.log(o.anotherValue); // 5

// Using Object.defineProperty
var o = {};
Object.defineProperty(o, 'value', {
  set: function(val) {
    this.anotherValue = val;
  }
});
o.value = 5;
console.log(o.value); // undefined
console.log(o.anotherValue); // 5

Specifications

Specification
ECMAScript Language Specification (ECMAScript) # sec-object.prototype.__defineSetter__

Browser compatibility

	Desktop						Mobile
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	WebView Android	Chrome Android	Firefox for Android	Opera Android	Safari on IOS	Samsung Internet
`__defineSetter__`	1	12	1 Starting with Firefox 48, this method can no longer be called at the global scope without any object. A `TypeError` will be thrown otherwise. Previously, the global object was used in these cases automatically, but this is no longer the case.	11	9.5	3	1	18	4	10.1	1	1.0

Object.prototype.__defineSetter__()