屬性標誌和屬性描述符

我們知道，物件可以儲存屬性。

到目前為止，屬性對我們來說只是一個簡單的“鍵值”對。但物件屬性實際上是更靈活且更強大的東西。

在本章中，我們將學習其他配置選項，在下一章中，我們將學習如何將它們無形地轉換為 getter/setter 函式。

屬性標誌

物件屬性（properties），除value外，還有三個特殊的特性（attributes），也就是所謂的“標誌”：

• writable— 如果為true，則值可以被修改，否則它是隻可讀的。
• enumerable— 如果為true，則會被在迴圈中列出，否則不會被列出。
• configurable— 如果為true，則此特性可以被刪除，這些屬性也可以被修改，否則不可以。

我們到現在還沒看到它們，是因為它們通常不會出現。當我們用“常用的方式”建立一個屬性時，它們都為true。但我們也可以隨時更改它們。

首先，讓我們來看看如何獲得這些標誌。

Object.getOwnPropertyDescriptor方法允許查詢有關屬性的完整資訊。

語法是：

let descriptor = Object.getOwnPropertyDescriptor(obj, propertyName);

obj

需要從中獲取資訊的物件。

propertyName

屬性的名稱。

返回值是一個所謂的“屬性描述符”物件：它包含值和所有的標誌。

例如：

let user = {
  name: "John"
};

let descriptor = Object.getOwnPropertyDescriptor(user, 'name');

alert( JSON.stringify(descriptor, null, 2 ) );
/* 屬性描述符：
{
  "value": "John",
  "writable": true,
  "enumerable": true,
  "configurable": true
}
*/
 

為了修改標誌，我們可以使用Object.defineProperty。

語法是：

Object.defineProperty(obj, propertyName, descriptor)

obj，propertyName

要應用描述符的物件及其屬性。

descriptor

要應用的屬性描述符物件。

如果該屬性存在，defineProperty會更新其標誌。否則，它會使用給定的值和標誌建立屬性；在這種情況下，如果沒有提供標誌，則會假定它是false。

例如，這裡建立了一個屬性name，該屬性的所有標誌都為false：

let user = {};

Object.defineProperty(user, "name", {
  value: "John"
});

let descriptor = Object.getOwnPropertyDescriptor(user, 'name');

alert( JSON
 
.stringify(descriptor, null, 2 ) );
/*
{
  "value": "John",
  "writable": false,
  "enumerable": false,
  "configurable": false
}
 */

將它與上面的“以常用方式建立的”user.name進行比較：現在所有標誌都為false。如果這不是我們想要的，那麼我們最好在descriptor中將它們設定為true。

現在讓我們通過示例來看看標誌的影響。

只讀

讓我們通過更改writable標誌來把user.name設定為只讀（user.name不能被重新賦值）：

let user = {
  name: "John"
};

Object.defineProperty(user, "name", {
  writable: false
});

user.name = "Pete"; // Error: Cannot assign to read only property 'name'

現在沒有人可以改變我們user的name，除非它們應用自己的defineProperty來覆蓋我們的user的name。

在非嚴格模式下，在對不可寫的屬性等進行寫入操作時，不會出現錯誤。但是操作仍然不會成功。在非嚴格模式下，違反標誌的行為（flag-violating action）只會被默默地忽略掉。

這是相同的示例，但針對的是屬性不存在的情況：

let user = { };

Object.defineProperty(user, "name", {
  value: "John",
  // 對於新屬性，我們需要明確地列出哪些是 true
  enumerable: true,
  configurable: true
});

alert(user.name); // John
user.name = "Pete"; // Error

不可列舉

現在讓我們向user新增一個自定義的toString。

通常，物件的內建toString是不可列舉的，它不會顯示在for..in中。但是如果我們新增我們自己的toString，那麼預設情況下它將顯示在for..in中，如下所示：

let user = {
  name: "John",
  toString() {
    return this.name;
  }
};

// 預設情況下，我們的兩個屬性都會被列出：
for (let key in user) alert(key); // name, toString

如果我們不喜歡它，那麼我們可以設定enumerable:false。之後它就不會出現在for..in迴圈中了，就像內建的toString一樣：

let user = {
  name: "John",
  toString() {
    return this.name;
  }
};

Object.defineProperty(user, "toString", {
  enumerable: false
});

// 現在我們的 toString 消失了：
for (let key in user) alert(key); // name

不可列舉的屬性也會被Object.keys排除：

alert(Object.keys(user)); // name

不可配置

不可配置標誌（configurable:false）有時會預設在內建物件和屬性中。

不可配置的屬性不能被刪除。

例如，Math.PI是隻讀的、不可列舉和不可配置的：

let descriptor = Object.getOwnPropertyDescriptor(Math, 'PI');

alert( JSON.stringify(descriptor, null, 2 ) );
/*
{
  "value": 3.141592653589793,
  "writable": false,
  "enumerable": false,
  "configurable": false
}
*/

因此，開發人員無法修改Math.PI的值或覆蓋它。

Math.PI = 3; // Error

// 刪除 Math.PI 也不會起作用

使屬性變成不可配置是一條單行道。我們無法使用defineProperty把它改回去。

確切地說，不可配置性對defineProperty施加了一些限制：

1. 不能修改configurable標誌。
2. 不能修改enumerable標誌。
3. 不能將writable: false修改為true（反過來則可以）。
4. 不能修改訪問者屬性的get/set（但是如果沒有可以分配它們）。

"configurable: false" 的用途是防止更改和刪除屬性標誌，但是允許更改物件的值。

這裡的user.name是不可配置的，但是我們仍然可以更改它，因為它是可寫的：

let user = {
  name: "John"
};

Object.defineProperty(user, "name", {
  configurable: false
});

user.name = "Pete"; // 正常工作
delete user.name; // Error

現在，我們將user.name設定為一個“永不可改”的常量：

let user = {
  name: "John"
};

Object.defineProperty(user, "name", {
  writable: false,
  configurable: false
});

// 不能修改 user.name 或它的標誌
// 下面的所有操作都不起作用：
user.name = "Pete";
delete user.name;
Object.defineProperty(user, "name", { value: "Pete" });

Object.defineProperties

有一個方法Object.defineProperties(obj, descriptors)，允許一次定義多個屬性。

語法是：

Object.defineProperties(obj, {
  prop1: descriptor1,
  prop2: descriptor2
  // ...
});

例如：

Object.defineProperties(user, {
  name: { value: "John", writable: false },
  surname: { value: "Smith", writable: false },
  // ...
});

所以，我們可以一次性設定多個屬性。

Object.getOwnPropertyDescriptors

要一次獲取所有屬性描述符，我們可以使用Object.getOwnPropertyDescriptors(obj)方法。

它與Object.defineProperties一起可以用作克隆物件的“標誌感知”方式：

let clone = Object.defineProperties({}, Object.getOwnPropertyDescriptors(obj));

通常，當我們克隆一個物件時，我們使用賦值的方式來複制屬性，像這樣：

for (let key in user) {
  clone[key] = user[key]
}

……但是，這並不能複製標誌。所以如果我們想要一個“更好”的克隆，那麼Object.defineProperties是首選。

另一個區別是for..in會忽略 symbol 型別的屬性，但是Object.getOwnPropertyDescriptors返回包含 symbol 型別的屬性在內的所有屬性描述符。

設定一個全域性的密封物件

屬性描述符在單個屬性的級別上工作。

還有一些限制訪問整個物件的方法：

Object.preventExtensions(obj)

禁止向物件新增新屬性。

Object.seal(obj)

禁止新增/刪除屬性。為所有現有的屬性設定configurable: false。

Object.freeze(obj)

禁止新增/刪除/更改屬性。為所有現有的屬性設定configurable: false, writable: false。

還有針對它們的測試：

Object.isExtensible(obj)

如果新增屬性被禁止，則返回false，否則返回true。

Object.isSealed(obj)

如果新增/刪除屬性被禁止，並且所有現有的屬性都具有configurable: false則返回true。

Object.isFrozen(obj)

如果新增/刪除/更改屬性被禁止，並且所有當前屬性都是configurable: false, writable: false，則返回true。

這些方法在實際中很少使用。