萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

JavaScript 物件屬性描述符完整指南:writable、enumerable、configurable 深度解析

前言

ECMAScript 5 引入屬性描述符,讓開發者能精細控制物件屬性的行為:是否可寫、是否可枚舉、是否可配置/刪除。掌握這三大屬性(writable、enumerable、configurable)與 Object.defineProperty、Object.getOwnPropertyDescriptor 的用法,是進階 JS 開發的必修課。

屬性描述符的兩種形態

類型屬性鍵說明
資料屬性value, writable, enumerable, configurable儲存具體數值
存取器屬性get, set, enumerable, configurable透過 getter/setter 存取,無 writable、value

三大核心屬性詳解

1. writable(資料屬性專屬)

  • true:可用賦值運算子修改 value。
  • false:嚴格模式下拋出 TypeError,非嚴格模式靜默失敗。

2. enumerable

  • true:for...in、Object.keys()、JSON.stringify() 會包含此屬性。
  • false:上述操作會忽略,但仍可直接存取。

3. configurable

  • true:可刪除屬性(delete obj.prop)、可修改描述符(除 writable: false → true)、可在資料/存取器間轉換。
  • false:不可逆,僅能將 writable: true → false,其他修改皆拋錯。

實戰 API 操作

讀取描述符

var obj = { x: 1 };
Object.getOwnPropertyDescriptor(obj, 'x');
// { value: 1, writable: true, enumerable: true, configurable: true }

// 繼承屬性回傳 undefined
var child = Object.create(obj);
Object.getOwnPropertyDescriptor(child, 'x'); // undefined

定義/修改單一屬性

var obj = {};

// 新增唯讀、不可枚舉、不可配置的常數
Object.defineProperty(obj, 'PI', {
    value: 3.14159,
    writable: false,
    enumerable: false,
    configurable: false
});

// 定義存取器屬性
var _age = 0;
Object.defineProperty(obj, 'age', {
    get: function() { return _age; },
    set: function(v) { if (v >= 0) _age = v; },
    enumerable: true,
    configurable: true
});

批量定義

Object.defineProperties(obj, {
    'name': { value: 'Tom', writable: true, enumerable: true, configurable: true },
    'id':   { value: 100, writable: false, enumerable: false, configurable: false }
});

修改規則與常見陷阱

  1. 不可擴展物件:Object.preventExtensions(obj) 後無法新增屬性,只能修改既有屬性。
  2. configurable: false 時:
    • 不可改 configurable、enumerable。
    • writable 只能 true → false,不可反向。
    • 存取器的 get/set 不可變更。
  3. writable: false && configurable: false:value 完全凍結,不可改。
  4. writable: false && configurable: true:value 仍可透過 defineProperty 修改(因 configurable 允許重新定義)。

實用模式:凍結物件層級

// 淺層凍結:自身屬性不可增刪改,值若為物件仍可修改其內部
Object.freeze(obj);

// 深度凍結(遞迴)
function deepFreeze(obj) {
    Object.freeze(obj);
    Object.keys(obj).forEach(key => {
        if (typeof obj[key] === 'object' && obj[key] !== null) deepFreeze(obj[key]);
    });
    return obj;
}

總結

屬性描述符賦予 JS 物件「元編程」能力:資料屬性控制值與可寫性,存取器屬性實現計算屬性與驗證邏輯,enumerable 決定序列化與枚舉行為,configurable 則是修改描述符本身的總開關。善用 Object.defineProperty 可建立唯讀常數、私有狀態封裝、防篡改配置物件等進階模式。

copyright © 萬盛學電腦網 all rights reserved