通过 Proxy 实现单例模式的透明封装

Proxy 提供了一种优雅且非侵入式的透明单例实现方案：它通过 construct 拦截器在 new 操作发生时动态控制实例创建，将单例逻辑完全外置到代理层，既无需修改原类代码、不污染构造函数逻辑，又能保持自然的 new MyClass() 调用方式，同时确保 instanceof 有效、原型链完整、继承关系不变；相比传统闭包或静态变量方案，它真正实现了“使用者无感、原类零改造、逻辑高内聚”的单例封装，尤其适合在不改动现有类的前提下快速赋予其单例语义。

Proxy 本身不直接创建单例，但它能以“不侵入原类”的方式，把单例逻辑封装在代理层，让使用者仍用 new MyClass() 调用，却始终拿到同一个实例——这就是透明单例的核心。

为什么 Proxy 更适合做透明封装

传统闭包单例（如 IIFE + instance 缓存）要求你改写构造函数逻辑，或额外暴露工厂函数，破坏了类的自然使用方式。而 Proxy 可以拦截 new 操作（通过 construct trap），在实例化那一刻动态控制返回值，原类完全不用动。

关键点：

• 原类保持纯净：不加 if (instance) return instance 这类判断，也不依赖静态属性或闭包变量
• 单例逻辑外置：所有“只生成一次”的判断和缓存，都放在 handler 里
• 调用方式零感知：用户仍写 new Service()，结果自动是单例

基础实现：拦截 construct 拦截器

核心是利用 Proxy 的 construct trap，在每次 new 时检查是否已有实例，有则复用，无则新建并缓存：

示例代码：

class RealService {
  constructor(url) {
    this.url = url;
    console.log('RealService created:', url);
  }
  fetch() { return `data from ${this.url}`; }
}

// 单例代理工厂
function createSingletonProxy(OriginClass) {
  let instance = null;
  return new Proxy(function(...args) {
    // 这个函数只是占位，实际不执行
  }, {
    construct(target, args, newTarget) {
      if (!instance) {
        instance = new OriginClass(...args);
      }
      return instance;
    }
  });
}

const Service = createSingletonProxy(RealService);
const a = new Service('https://api.a');
const b = new Service('https://api.b'); // 参数被忽略，仍返回 a
console.log(a === b); // true

进阶：支持参数校验与首次初始化差异化

如果首次调用的参数很重要（比如配置项），而后续调用应忽略或报错，可在 construct 中加判断：

• 允许首次传参，之后传参不生效但不报错 → 直接忽略 args
• 要求参数必须一致 → 对比已存实例的初始化参数，不一致则 throw
• 首次未传参，后续才传 → 可延迟初始化（类似懒加载）

例如强制首参一致：

construct(target, args, newTarget) {
  if (!instance) {
    instance = new OriginClass(...args);
    instance.__initArgs = args;
  } else if (JSON.stringify(args) !== JSON.stringify(instance.__initArgs)) {
    throw new Error('Singleton instance already created with different args');
  }
  return instance;
}

注意事项与边界情况

Proxy 封装单例虽透明，但有几点必须留意：

• 无法代理原始构造函数：像 function Foo(){} 这类函数不能直接被 Proxy 构造拦截，需转为 class 或包装成可 new 的函数
• instanceof 仍有效：返回的实例仍是原类的实例，a instanceof RealService 为 true
• 原型链不受影响：方法、继承关系全部保留，Proxy 只控制实例创建过程
• 不适用于需要多实例场景的类：一旦用了该 Proxy，就彻底锁死单例语义，不可逆

它不是万能替代，而是当你明确需要“对现有类零改造实现单例”时，最干净的解法。

好了，本文到此结束，带大家了解了《通过 Proxy 实现单例模式的透明封装》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多文章知识！