Node.js中ESM模块支持顶层await导出异步值的特性名称是什么?
特性名称与归属
你观察到的这个特性官方名称是 顶层await(Top-level await),它属于正式的ECMAScript标准特性,并非Node.js独有,目前所有支持ES模块的现代运行环境(包括主流浏览器、Deno等)都已实现该特性。
特性背景与运行原理
- 该特性在ES2022(ES13)版本中被正式纳入ECMAScript标准,这也是你印象中早年无法使用的原因:标准落地前没有统一实现,各大运行环境也未完成适配。Node.js从v14.8.0版本开始正式支持顶层await,你使用的14.17.3属于后续迭代版本,已经包含该特性支持。
- 当一个ES模块的顶层作用域中出现
await语句时,该模块会被标记为异步模块:模块加载器会等待顶层await后的Promise完全决议之后,才会继续执行所有依赖该模块的其他模块代码,同时该模块的导出值会自动绑定到Promise的决议结果。 - ES模块天然具备单例缓存特性,所以你的示例中a.js被b.js、c.js同时依赖时,只会执行一次,两个模块拿到的是同一份缓存的导出结果,不会重复触发wait函数执行。
内容的提问来源于stack exchange,提问作者Geordie
相关产品推荐
相关产品推荐

