如何使用 Proxy 和 Reflect 构建一个不可变的数据存储库？

在JavaScript里，普通对象随时可以被修改，这在多人协作或状态管理时容易引发难以追踪的bug。通过Proxy配合Reflect，我们可以拦截对对象的读写行为，从而构建一个不可变的数据存储库，让数据只能读取不能变更。

为什么需要不可变存储

不可变数据能带来更可预测的状态变化，方便做变更追踪和回滚。传统做法是用Object.freeze，但它只是浅冻结，且不会在修改时给出明确反馈。使用Proxy能在拦截层做更灵活的控制。

核心设计思路

我们将原始数据放在闭包中，对外暴露一个被Proxy包装的对象。在get操作中利用Reflect.get返回数据；在set、deleteProperty等修改操作中直接抛出错误，阻止变更。

• get：正常读取，若属性是对象可继续用Proxy包装
• set：抛出错误，拒绝写入
• deleteProperty：抛出错误，拒绝删除
• has、ownKeys：通过Reflect透传

完整代码示例

下面给出一个简单的不可变存储实现：

// 创建不可变数据存储库
function createImmutableStore(data) {
  // 递归包装，保证嵌套对象也不可变
  function wrap(target) {
    if (target === null || typeof target !== 'object') {
      return target;
    }
    return new Proxy(target, {
      get(obj, key, receiver) {
        // 允许访问Symbol.iterator等内部符号
        const value = Reflect.get(obj, key, receiver);
        if (typeof key === 'symbol') {
          return value;
        }
        // 嵌套对象继续包装
        if (value && typeof value === 'object') {
          return wrap(value);
        }
        return value;
      },
      set() {
        throw new TypeError('Cannot set property on immutable store');
      },
      deleteProperty() {
        throw new TypeError('Cannot delete property on immutable store');
      },
      defineProperty() {
        throw new TypeError('Cannot define property on immutable store');
      }
    });
  }
  return wrap(data);
}

// 使用示例
const store = createImmutableStore({ name: 'test', info: { age: 20 } });
console.log(store.name); // test
console.log(store.info.age); // 20
try {
  store.name = 'new'; // 抛出错误
} catch (e) {
  console.log(e.message);
}

注意事项

该方案在运行时拦截，性能相较于裸对象略有损耗，不适合超高频读写场景。另外，Reflect的默认行为能保证原型链查找正确，因此拦截器中应尽量通过Reflect调用原方法。

不可变存储并非让数据永远不变，而是让外部代码无法通过引用直接改源数据，从机制上减少误修改。

小结

利用Proxy和Reflect，我们可以用少量代码构建出安全、清晰的不可变数据存储库，在需要保护配置、状态快照时非常实用。

ProxyReflectimmutable_store修改时间：2026-07-26 04:12:15