JS函数执行延迟失效问题：await使用报错求助

API 探路者

2026-7-6

问题分析与解决方案

报错原因

VS Code的报错逻辑很清晰：await表达式仅能在async函数内部或者ES模块的顶层作用域中使用。你直接在全局作用域（非async函数、非模块顶层）调用await sleep(1500)，不符合JavaScript语法规则，因此触发错误。

优化后的sleep函数

你的sleep函数可以简化——new Promise本身就是异步对象，不需要额外用async/await包裹，直接返回Promise即可：

const sleep = (milliseconds) => {
    return new Promise(resolve => setTimeout(resolve, milliseconds));
};

两种可行解决方案

方案1：将代码包裹在async函数中执行

这是通用写法，无论项目是否为ES模块都能生效：

const sleep = (milliseconds) => {
    return new Promise(resolve => setTimeout(resolve, milliseconds));
};

// 用async函数包裹需要按顺序执行的代码
async function executeSequence() {
    await sleep(1500);
    console.log("waited for 1.5 seconds.");
}

// 调用async函数触发执行
executeSequence();

方案2：使用ES模块的顶层await

如果你的项目配置了ES模块（满足以下任一条件）：

脚本文件后缀为.mjs
项目根目录的package.json中添加了"type": "module"

则可以直接在文件顶层使用await，无需包裹函数：

const sleep = (milliseconds) => {
    return new Promise(resolve => setTimeout(resolve, milliseconds));
};

await sleep(1500);
console.log("waited for 1.5 seconds.");