JavaScript 顶层作用域自ES2022起原生支持await，但需满足ES模块环境、Node.js≥14.8、浏览器script type="module"等前提；不支持时可用IIFE或异步初始化函数替代。
JavaScript 中顶层作用域（即模块最外层、非函数内）**原本不支持直接使用 await**，但在现代环境（ES2022 起）已通过 顶层 await 特性原生支持——前提是运行在支持该特性的环境中（如 Node.js 14.8+、现代浏览器模块脚本、TypeScript 3.8+ 编译输出等）。
✅ 顶层 await 的使用前提
要让 await 在模块顶层生效，必须满足：
- 代码需作为 ES 模块（
.mjs文件或type="module"的 script 标签） 运行； - Node.js 版本 ≥ 14.8（推荐 ≥ 16.0），且未禁用
--experimental-top-level-await（旧版需显式开启，新版默认启用）； - 浏览器中仅支持
<script type="module">内的顶层 await，不支持普通 script； - TypeScript 需配置
"target": "ES2022"或更高，并启用"module": "ESNext"或"NodeNext"。
✅ 正确写法示例
以下代码在合规环境中可直接运行：
// main.mjs 或 index.js（配合 "type": "module"）
const response = await fetch('https://api.example.com/data');
const data = await response.json();
console.log(data); // ✅ 合法：顶层 await
❌ 不支持场景与替代方案
若环境不支持顶层 await（如 CommonJS、旧版 Node、打包工具未适配），需改用以下方式：
立即学习“Java免费学习笔记（深入）”；
-
立即执行异步函数（IIFE）：
(async () => { const res = await fetch(...); console.log(res); })(); -
导出一个异步初始化函数，由入口调用：
export async function init() { ... }→ 入口处init().catch(console.error)； -
使用
Promise.then()链式处理（不推荐嵌套过深，但兼容性最好）。
⚠️ 注意事项
顶层 await 会让整个模块的加载变为异步，影响模块依赖顺序：
- 其他模块
import该模块时，会等待其顶层 await 完成后再继续执行； - 不能在
if或循环中动态使用顶层 await（语法错误）； - 错误需用
try/catch包裹顶层 await，否则模块加载失败，抛出TypeError； - CommonJS（
require()）无法加载含顶层 await 的 ES 模块，应统一模块系统。
