JS 中 ES Modules 导出异步函数怎么处理-js教程-PHP中文网

es modules 中不能直接导出 await 表达式，但可导出 async 函数或已执行的 promise；推荐导出异步函数以支持多次调用和错误处理，若需模块加载时完成异步操作则用顶层 await（先赋值再导出）。

js 中 es modules 导出异步函数怎么处理

ES Modules 中不能直接导出一个 await 表达式，但可以导出异步函数本身（async function），也可以导出一个已执行的 Promise。关键在于区分“导出函数”和“导出等待结果”两种需求。

导出异步函数（推荐）

这是最常见、最安全的做法：把异步逻辑封装在 async function 里，然后正常命名或默认导出。调用方按需 await 即可。

函数体内部处理错误，外部调用更可控
支持多次调用，不依赖模块初始化时机
兼容所有 ESM 环境，无顶层 await 限制

示例：

utils.js

export async function fetchUser(id) {
  const res = await fetch(`/api/user/${id}`);
  if (!res.ok) throw new Error('Failed to fetch user');
  return res.json();
}
<p>// 可同时导出默认异步函数
export default async function initApp() {
console.log('starting...');
await fetchUser(1);
return 'ready';
}</p>

使用时：

chartjs-reporter

此技能用于在用户需要将结构化数据（查询结果、CSV 摘要、JSON 记录或 Python 字典/列表）转换为独立的 HTML 页面时使用。

下载

import { fetchUser } from './utils.js';
import initApp from './utils.js';
<p>await fetchUser(42);
await initApp();</p>

导出已解析的异步值（需顶层 await）

如果确实需要模块加载时就完成异步操作（比如读取配置、初始化连接），可用顶层 await，但必须遵守规则：

先赋值给变量，再 export，不能写 export default await …（语法错误）
模块类型必须是 type="module"，Node 需 ≥14.8 且 "type": "module"
一旦 await 失败，整个模块加载中断，无法用顶层 try/catch 捕获

示例：

config.js

const configPromise = fetch('/config.json').then(r => r.json());
<p>// ✅ 正确：先 await 赋值，再导出
const config = await configPromise;
export { config };
// 或 export default config;</p>