如何利用 Object.defineProperty 的 enumerable 特性构建具备隐藏内部逻辑的业务模型-js教程-PHP中文网

object.defineproperty 的 enumerable: false 可隐藏私有状态和计算属性，避免被遍历、解构或序列化，同时支持内部读写和受控访问，是构建简洁业务模型的有效手段。

如何利用 object.defineproperty 的 enumerable 特性构建具备隐藏内部逻辑的业务模型

利用 Object.defineProperty 的 enumerable: false 特性，可以将模型内部状态或计算逻辑“藏”起来，既保持接口简洁，又避免被遍历、解构或意外修改，是构建干净业务模型的有效手段。

隐藏私有状态字段，防止外部遍历暴露

业务模型常需维护一些中间状态（如缓存、标记位、上次更新时间），这些不应出现在 for...in、Object.keys() 或 JSON 序列化中。设为 enumerable: false 后，它们不会被枚举，但依然可被代码内部正常读写。

例如：

```js
class OrderModel {
  constructor(id, items) {
    this.id = id;
    this.items = items;
    // 隐藏内部缓存字段
    Object.defineProperty(this, '_cachedTotal', {
      value: null,
      writable: true,
      enumerable: false,
      configurable: true
    });
  }

  get total() {
    if (this._cachedTotal === null) {
      this._cachedTotal = this.items.reduce((sum, i) => sum + i.price * i.qty, 0);
    }
    return this._cachedTotal;
  }
}

const order = new OrderModel('ORD-001', [{ price: 99, qty: 2 }]);
console.log(Object.keys(order)); // ['id', 'items'] —— 不含 '_cachedTotal'
console.log(JSON.stringify(order)); // {"id":"ORD-001","items":[{...}]}
```

封装只读/惰性计算属性，不暴露实现细节

用 enumerable: false 配合 get 描述符，可定义一个“看不见但可用”的计算属性。它不会出现在对象遍历结果中，但调用时仍能触发逻辑，适合隐藏复杂推导过程。

例如：

```js
function createUserModel(data) {
  const model = { ...data };

  // 内部辅助方法，不希望被外部看到
  Object.defineProperty(model, '_isValidEmail', {
    get() {
      return /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(model.email);
    },
    enumerable: false
  });

  // 公开的 isValid 属性，基于隐藏逻辑
  Object.defineProperty(model, 'isValid', {
    get() { return model._isValidEmail && model.name?.trim(); },
    enumerable: true // 显式暴露给用户
  });

  return model;
}

const user = createUserModel({ name: 'Alice', email: 'alice@example.com' });
console.log(user.isValid); // true
console.log('_isValidEmail' in user); // true
console.log(Object.keys(user)); // ['name', 'email', 'isValid'] —— _isValidEmail 不出现
```