JS: Object.defineProperty

Object.defineProperty(obj, key, descriptor)

Create a property with specified attribute values (if key doesn't exist), or modify a existing property's attributes.

Return the modified object obj.

descriptor is a syntax for property value and attributes.

[see JS: Property Descriptor]

[see JS: Property Attributes, writable, enumerable, configurable]

// using Object.defineProperty

var x = {};

// define a property and assign its value and attributes
Object.defineProperty(x, "p",
{ value : 3, writable: true, enumerable: false, configurable: true}
);

console.log(x["p"]);            // 3

Make a property read-only:

// example of setting property to be read-only

// "use strict"

var oy = {"p":3};

Object.defineProperty(oy, "p", { writable: false} );

oy["p"] = 4;                    // no effect
// if in use strict mode, then it's
// TypeError: Cannot assign to read only property 'p' of #<Object>

console.log(oy["p"]);           // 3

Note: once a property's “writable” attribute is set false, it can't be set back to true.

ECMAScript® 2016 Language Specification#sec-invariants-of-the-essential-internal-methods

Default Values for Property Descriptor

Property Descriptor default values for all attributes is false, and for value attribute it defaults to undefined.

[see JS: Property Descriptor]

Define Getter Property

Object.defineProperty(object_name, key, { get : function_with_0_param, enumerable: false, configurable: true});

var ob = {p1:3};

// add a getter property key "g"
Object.defineProperty(ob, "g", { get : function () { console.log("getter called ") }});

ob.g;
// prints: getter called

[see JS: Getter/Setter Properties]

Define Setter Property

Object.defineProperty(object_name, key, { set : function_with_1_param, enumerable: false, configurable: true});

var ob = {p1:3};

// add a setter property key "s"
Object.defineProperty(ob, "s", { set : function (x) { console.log("setter called with arg " +x) }});

ob.s = 4;
// prints: setter called with arg 4

[see JS: Getter/Setter Properties]

Define Multiple Properties

[see JS: Object.defineProperties]

Reference

ECMAScript® 2016 Language Specification#sec-object.defineproperty