Object.defineProperty()

對象的定義

對象是由多個名/值成對組成的無序的集合。對象中每一個屬性對應任意類型的值。
定義對象能夠使用構造函數或字面量的形式：

//採用構造函數方式，構造一個空對象。
 var obj = new Object; obj.name = "張三";  //添加屬性
 obj.say = function(){};  //添加方法 //採用字面量方式建立對象
var obj={}； obj.name = "張三";  //添加屬性
obj.say = function(){};  //添加方法

除了以上方式外還有一種方式Object.defineProperty能夠給對象添加屬性或者修改屬性。

Object.defineProperty()

Object.defineProperty() 方法會直接在一個對象上定義一個新屬性，或者修改一個對象的現有屬性， 並返回這個對象。

語法

Object.defineProperty(obj, prop, descriptor)

參數

obj要在其上定義屬性的對象。

prop要定義或修改的屬性的名稱。

descriptor將被定義或修改的屬性描述符。

返回值

被傳遞給函數的對象。

該方法容許精確添加或修改對象的屬性。經過賦值操做添加的普通屬性是可枚舉的，可以在屬性枚舉期間呈現出來（for...in 或 Object.keys 方法），

這些屬性的值能夠被改變，也能夠被刪除。這個方法容許修改默認的額外選項（或配置）。默認狀況下，使用 Object.defineProperty() 添加的屬性

值是不可修改的。

屬性描述符

對象裏目前存在的屬性描述符有兩種主要形式：數據描述符和存取描述符。數據描述符是一個具備值的屬性，該值多是可寫的，也可能不是可寫的。

存取描述符是由getter-setter函數對描述的屬性。描述符必須是這兩種形式之一；不能同時是二者。

數據描述符和存取描述符均具備如下可選鍵值：

configurable當且僅當該屬性的 configurable 爲 true 時，該屬性描述符纔可以被改變，同時該屬性也能從對應的對象上被刪除。默認爲 false。

enumerable當且僅當該屬性的enumerable爲true時，該屬性纔可以出如今對象的枚舉屬性中。默認爲 false。

數據描述符同時具備如下可選鍵值：

value該屬性對應的值。能夠是任何有效的 JavaScript 值（數值，對象，函數等）。默認爲 undefined。

writable當且僅當該屬性的writable爲true時，value才能被賦值運算符改變。默認爲 false。

存取描述符同時具備如下可選鍵值：

get一個給屬性提供 getter 的方法，若是沒有 getter 則爲 undefined。當訪問該屬性時，該方法會被執行，方法執行時沒有參數傳入，可是會傳

入this對象（因爲繼承關係，這裏的this並不必定是定義該屬性的對象）。默認爲 undefined。

set一個給屬性提供 setter 的方法，若是沒有 setter 則爲 undefined。當屬性值修改時，觸發執行該方法。該方法將接受惟一參數，即該屬性新

的參數值。默認爲 undefined。

描述符可同時具備的鍵值：

若是一個描述符不具備value,writable,get 和 set 任意一個關鍵字，那麼它將被認爲是一個數據描述符。若是一個描述符同時有(value或

writable)和(get或set)關鍵字，將會產生一個異常。

示例

建立屬性

若是對象中不存在指定的屬性，Object.defineProperty()就建立這個屬性。當描述符中省略某些字段時，這些字段將使用它們的默認值。擁有布爾值

的字段的默認值都是false。value，get和set字段的默認值爲undefined。一個沒有get/set/value/writable定義的屬性被稱爲「通用的」，並被「鍵入」

爲一個數據描述符。示例：

var o = {}; // 建立一個新對象

// 在對象中添加一個屬性與數據描述符的示例
Object.defineProperty(o, "a", { value : 37, writable : true, enumerable : true, configurable : true }); // 對象o擁有了屬性a，值爲37

// 在對象中添加一個屬性與存取描述符的示例
var bValue; Object.defineProperty(o, "b", { get : function(){ return bValue; }, set : function(newValue){ bValue = newValue; }, enumerable : true, configurable : true }); o.b = 38; // 對象o擁有了屬性b，值爲38

// o.b的值如今老是與bValue相同，除非從新定義o.b

// 數據描述符和存取描述符不能混合使用
Object.defineProperty(o, "conflict", { value: 0x9f91102, get: function() { return 0xdeadbeef; } });

修改屬性

若是屬性已經存在，Object.defineProperty()將嘗試根據描述符中的值以及對象當前的配置來修改這個屬性。若是舊描述符將其configurable 屬性

設置爲false，則該屬性被認爲是「不可配置的」，而且沒有屬性能夠被改變（除了單向改變 writable 爲 false）。當屬性不可配置時，不能在數

據和訪問器屬性類型之間切換。

當試圖改變不可配置屬性（除了value和writable 屬性以外）的值時會拋出TypeError，除非當前值和新值相同。

var o = {}; // Creates a new object
 Object.defineProperty(o, 'a', { value: 37, writable: false }); console.log(o.a); // logs 37
o.a = 25; // No error thrown // (it would throw in strict mode, // even if the value had been the same)
console.log(o.a); // logs 37. The assignment didn't work.

// strict mode
(function() { 'use strict'; var o = {}; Object.defineProperty(o, 'b', { value: 2, writable: false }); o.b = 3; // throws TypeError: "b" is read-only
  return o.b; // returns 2 without the line above
}());

如示例所示，試圖寫入非可寫屬性不會改變它，也不會引起錯誤。

添加多個屬性和默認值

考慮特性被賦予的默認特性值很是重要，一般，使用點運算符和Object.defineProperty()爲對象的屬性賦值時，數據描述符中的屬性默認值是不一樣的，

以下例所示。

var o = {}; o.a = 1; // 等同於 :
Object.defineProperty(o, "a", { value : 1, writable : true, configurable : true, enumerable : true }); // 另外一方面，
Object.defineProperty(o, "a", { value : 1 }); // 等同於 :
Object.defineProperty(o, "a", { value : 1, writable : false, configurable : false, enumerable : false });

詳情請見：https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Object/defineProperty