Proxy更适合实现透明单例,因为它通过construct trap拦截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,就彻底锁死单例语义,不可逆
它不是万能替代,而是当你明确需要“对现有类零改造实现单例”时,最干净的解法。











