Skip to content

Top-level Await

一句话解释

顶层 await 让你在 ES 模块顶层使用 await 关键字,无需包裹在 async 函数中。

用大白话说

顶层 await 让你在 ES 模块顶层——任何 async 函数之外——使用 await。此前 await 仅在 async 函数内合法,所以你必须把模块初始化包在 async IIFE 中。现在你可在模块作用域直接 await。这对需要在就绪前做异步工作的模块很有力:加载配置文件、获取初始数据、动态导入模块。使用顶层 await 的模块会阻塞其依赖者直到它完成——导入者等待被 await 的 promise 解析。它仅在 ES 模块中允许(非 CommonJS、非普通脚本)。用于模块初始化确实必须在模块可用前完成的情况。避免会阻塞整个应用启动的漫长顶层 await;对非关键异步工作优先懒加载。

示例

javascript
// config.js (ES module)
const response = await fetch("/api/config");
export const config = await response.json();

// main.js
import { config } from "./config.js";
// main.js waits until config.js's top-level await resolves
console.log(config.apiUrl);

config 模块在顶层 await fetch。导入者被阻塞直到其解析,因此 config 在它们运行时就绪。

相关术语

相关资源

相关课程

解读错误信息

用大白话解释常见错误——什么意思、为什么发生、如何修复。

查看错误

← 返回术语表