new.target是严格模式下检测构造函数非法调用的最可靠手段,应在构造器首行校验其存在性,并可配合私有状态与Proxy正确传参实现全链路防护。

严格模式下,普通调用构造函数会导致 this 为 undefined,赋值语句直接抛错,但错误位置常远离调用点,容易误判为“内部逻辑崩溃”,实则是调用方式错了。new.target 不依赖 this,也不受严格/非严格模式影响,是定位并阻断这类问题最干净的手段。
在构造器开头立即校验 new.target
这是最直接、零副作用的防护。只要 new.target 为 undefined,就说明不是通过 new 调用的:
- 写法统一:所有类或函数构造器第一行加
if (!new.target) throw new TypeError('Xxx 必须用 new 调用') - 覆盖全部非法场景:包括
Xxx()、Xxx.call(obj)、Xxx.apply(null)、Reflect.construct(Xxx, [])(注意:后者会传入 newTarget,所以不会触发该判断) - 比
this instanceof Xxx更可靠:后者在严格模式下this是undefined,会报错;非严格模式下又可能指向全局对象,产生隐蔽 bug
对基类做身份锁定,防止直连实例化
若某个类本意是抽象基类(如 Stream、Encoder),只应被继承,不许 new,可用 new.target === BaseClass 精准拦截:
- 子类调用
super()时,new.target是子类本身,条件不成立,放行 - 有人写
new BaseClass(),条件成立,立刻报错,错误堆栈明确指向构造器第一行 - 比文档约定或运行时类型检查更硬性,不靠自觉,运行即拦
配合私有状态守卫,堵住 this 提前泄露漏洞
即使加了 new.target 检查,如果构造器内启动了未 await 的异步任务(比如 fetch().then(...)),this 仍可能在初始化完成前被外部访问。这时需结合 new.target 做二次防护:
- 声明私有字段
#ready = false,构造器末尾不设为true - 关键方法(如
encrypt()、write())开头加守卫:if (!this.#ready) throw new Error(`${new.target.name} 尚未就绪`) - 异步初始化完成后才置
this.#ready = true,确保每次访问都有状态兜底
避免 Proxy construct 中 new.target 丢失导致的继承断裂
若用 Proxy 拦截构造过程(如日志、权限校验),必须显式将 newTarget 传给 Reflect.construct,否则 instanceof 失效、原型链断裂:
- 错误写法:
return Reflect.construct(target, args)→new.target丢失 - 正确写法:
return Reflect.construct(target, args, newTarget)→ 完整保留调用上下文 - 漏传会导致子类实例无法通过
instanceof判断,后续方法查找失败,看似“找不到方法”,实为原型链断开

















