Top-level await允许在模块顶层直接使用await，无需async函数包裹，简化异步依赖初始化。它适用于ES模块环境，支持动态加载配置、数据库连接等场景，但会阻塞模块执行，需避免长时间操作和循环依赖，Node.js需配置.mjs后缀或"type": "module"。
Top-level await 是 ES2022 引入的一项重要特性，它允许开发者在模块的顶层直接使用 await 关键字，而无需包裹在 async 函数中。这项功能极大简化了模块初始化时处理异步依赖的逻辑。
什么是 Top-level Await？
在以前的 JavaScript 版本中，await 只能在 async 函数内部使用。如果想在模块中等待一个 Promise，必须封装成异步函数并调用，这不仅繁琐，还可能破坏模块结构。
ES2022 支持在模块顶层使用 await，只要该文件是 ES Module（即 .mjs 或在 package.json 中声明 "type": "module"）。浏览器和 Node.js 都已支持这一特性。
实际应用场景
常见于以下几种情况：- 动态导入配置或环境变量（如从远程加载 config）
- 等待数据库连接建立后再导出服务实例
- 按需加载第三方 SDK 并确保其准备就绪
例如：
立即学习“Java免费学习笔记（深入）”；
const response = await fetch('https://api.example.com/config');
const config = await response.json();
export const API_URL = config.apiUrl;
export default function fetchData() {
return fetch(API_URL);
}
这个模块会阻塞后续的 import，直到 await 完成。也就是说，其他模块引入它时，能确保配置已经加载完毕。
注意事项与影响
由于 top-level await 会阻塞整个模块的执行，需要注意：
- 避免长时间阻塞主流程，尤其是用户界面场景
- 慎用于有副作用的异步操作，可能影响可预测性
- 循环依赖中使用时需格外小心，可能导致死锁或不可预期行为
另外，并非所有环境默认启用 ES 模块。Node.js 中需要将文件后缀设为 .mjs 或在 package.json 中设置 "type": "module"。
基本上就这些。top-level await 让异步模块初始化变得更直观自然，合理使用可以提升代码可读性和可靠性。
