javascript 的 class 构造函数必须同步返回实例，因此不能异步；推荐用静态工厂方法 async create() 或显式 init() 方法实现异步初始化，并注意继承顺序与状态缓存。
JavaScript 的 class 构造函数本身不能是异步的，也不能在 constructor 中使用 await 或返回 Promise。这不是限制，而是语言设计决定的：构造函数必须同步返回实例对象。想实现“创建即可用”的异步初始化，得换思路——把异步逻辑移出去，用更可控、更清晰的方式组织。
用静态工厂方法 async create()
这是最推荐的做法，语义明确、调用方无心智负担，拿到的就是已准备就绪的实例（或明确失败）。
- 工厂方法内部先完成所有异步操作（如
fetch、登录验证、SDK 加载） - 再调用
new MyClass()，把结果注入实例 - 统一处理错误，调用方只需
try/catch或.catch() - 示例：
class ApiClient {
constructor(baseUrl) { this.baseUrl = baseUrl; }
static async create(config) {
const token = await login(config.credentials);
const client = new ApiClient(config.baseUrl);
client.token = token;
return client;
}
}
const api = await ApiClient.create({ baseUrl: '/api', credentials: {...} });
提供显式 init() 方法并缓存状态
适合需要延迟加载、按需初始化，或希望部分方法能先运行、后续再补全能力的场景。
Wjs Uploading Video
下载
将一个或多个视频上传至YouTube。当用户想“上传到YouTube”“发YouTube”“批量上传”“upload to YouTube”“post videos to YouTube”或发布到YouTube时使用此技能。
- 构造函数只做轻量同步工作（赋值、校验、绑定）
-
init()返回Promise，内部用私有字段（如#initPromise）缓存执行结果 - 首次调用触发异步流程，后续调用直接复用 Promise（无论成功或失败）
- 其他业务方法开头检查：
if (!this.#initPromise) throw new Error('请先调用 init()')
继承体系中确保初始化顺序
父类和子类都可能有异步依赖，必须避免子类在 super() 后立即访问未就绪的数据。
- 父类定义
async init()，子类重写时第一行写await super.init() - 所有异步初始化逻辑都放在
init()链里，不塞进构造函数 - 可加
this.#isInitialized = false标志位，成功后置为true，供运行时校验 - 避免构建工具（如 esbuild）因优化打乱
super()和await的执行上下文
别踩这些坑
有些写法看似绕过了限制，实则埋下隐患。
- 在
constructor里用setTimeout或Promise.resolve().then()—— 实例早已返回，this上的属性仍是undefined，静默失败 - 构造函数里
return Promise——new拿到的是 Promise 对象，不是类实例，后续调用方法会报错 - 忘记状态管理，多次调用
init()导致重复请求或竞态 - 在类方法中用
await却不配try/catch，把错误甩给调用方，破坏封装性
