new.target 无法确保“异步迭代器流调度中心基类”的绝对安全实例化，因其仅识别构造调用者，不校验 Symbol.asyncIterator 实现、不验证返回值契约、也不保障调度线程安全与资源可控。
不能靠 new.target 确保“异步迭代器流调度中心基类”的绝对安全实例化——因为 new.target 本身不处理异步逻辑、不校验迭代器契约、也不约束 Symbol.asyncIterator 的实现是否正确。它只回答一个问题：“这个 constructor 是被哪个类直接 new 的？” 它能帮你拒绝误用、识别子类、注入日志，但无法保证一个类“是合格的异步迭代器”。
明确 new.target 的能力边界
new.target 是构造时的元信息，不是类型守门员。它在父类 constructor 中可做以下事：
- 判断是否被直接实例化（
new.target === BaseClass），从而抛错阻止非法调用 - 获取实际子类名（
new.target.name），用于日志、统计或路由分发 - 配合静态属性（如
new.target.requiresAsyncIterator = true）做前置声明校验 - 触发初始化钩子（如
this._initAsyncIterator()），但该方法本身仍需子类正确实现
真正保障“异步迭代器流调度中心”安全的关键动作
一个类要成为可靠的异步迭代器流调度中心，必须满足三项硬性条件，new.target 只能辅助其中第一项：
-
强制实现
[Symbol.asyncIterator]：在基类constructor中检查typeof this[Symbol.asyncIterator] !== 'function'，立即报错。这不是靠new.target发现的，而是靠运行时调用检查 -
确保返回值是合法的异步迭代器对象：即
[Symbol.asyncIterator]()必须返回含next()方法的对象，且next()返回Promise<{ value: any, done: boolean }>。这需在首次调用next()或通过单元测试验证 -
调度逻辑线程安全 & 资源可控：例如防止并发
next()调用导致状态混乱，或未取消的流持续占用内存。这靠设计模式（如单例 pending 队列、AbortSignal 绑定）而非构造拦截
一个实用的基类结构示例
把 new.target 当作“准入开关”，把真正校验交给构造后逻辑：
class AsyncStreamScheduler {
constructor() {
// ① 拒绝直接 new
if (new.target === AsyncStreamScheduler) {
throw new TypeError('AsyncStreamScheduler is abstract. Extend and implement [Symbol.asyncIterator].');
}
// ② 检查子类是否提供了 async iterator 方法（最简守门）
if (typeof this[Symbol.asyncIterator] !== 'function') {
throw new TypeError(`${new.target.name} must implement Symbol.asyncIterator method.`);
}
// ③ 可选：标记已通过基础校验
this._isStreamReady = false;
}
// 公共方法：供子类在构造末尾显式调用，完成最终就绪检查
_markAsReady() {
if (this._isStreamReady) return;
const iter = this[Symbol.asyncIterator]();
if (typeof iter.next !== 'function') {
throw new TypeError(`${new.target.name}: [Symbol.asyncIterator]().next is not a function.`);
}
this._isStreamReady = true;
}
}
// 正确子类写法
class UserEventStream extends AsyncStreamScheduler {
constructor(events) {
super();
this.events = events;
// ✅ 必须在此处完成初始化，并主动就绪
this._markAsReady();
}
[Symbol.asyncIterator]() {
let i = 0;
const self = this;
return {
next() {
if (i >= self.events.length) {
return Promise.resolve({ value: undefined, done: true });
}
return Promise.resolve({ value: self.events[i++], done: false });
}
};
}
}
为什么不能依赖 new.target 做“绝对安全”？
因为安全不是发生在 new 那一刻，而是在后续每次 for await...of 或 iterator.next() 调用中。哪怕构造成功，只要 next() 抛出未捕获异常、返回格式错误、或内部资源泄漏，整个流就不可靠。这些都超出了 new.target 的职责范围。
它是个好用的“门卫”，但不是“运维团队”。真正的安全来自：类型系统约束（TypeScript 声明）、运行时契约检查、压力测试、以及取消信号（AbortSignal）的全程绑定。
