如何正确处理异步函数返回的 Promise 对象

异步函数（如 async 声明的 API 调用）必然返回 Promise，不能直接获取解析后的值；需通过 await（在 async 上下文中）或 .then()（在同步上下文中）获取最终结果。

异步函数（如 `async` 声明的 API 调用）必然返回 Promise，不能直接获取解析后的值；需通过 `await`（在 async 上下文中）或 `.then()`（在同步上下文中）获取最终结果。

在用 Google Cloud Translation API 搭建翻译应用时，很多人一开始都会踩进同一个坑：以为 async 函数会“自己等完”，然后直接把已经解析好的结果交出来。可实际情况并不是这样。关键点在于，所有 async 函数都会隐式返回 Promise——哪怕你只是 return 了一个字符串（比如 return translation），这个字符串最终也不会原样返回，而是会被自动包进 Promise.resolve(translation) 里。

以你的代码为例：

async function getTranslation(text) {
const res = await axios.post(
`https://translation.googleapis.com/language/translate/v2?key=${_API_KEY}`,
{ q: text, target: "de" }
);
const translation = res.data.data.translations[0].translatedText;
console.log(translation); // ✅ 正确输出：Hello Welt
return translation; // ⚠️ 实际返回：Promise
}

因此，这行代码：

const message = getTranslation(text);
console.log(message); // → Promise {}，而非字符串

输出的是未决 Promise 对象，而非翻译结果。

✅ 正确做法有三种，按使用场景选择：

1. 使用 .then()（适用于普通脚本、事件回调等非 async 环境）

getTranslation("hello world").then(message => {
console.log(message); // ✅ 输出：Hello Welt
// 在此处继续处理 message（如更新 DOM、存入 state）
});

2. 使用 await（必须在 async 函数内部）

const doTranslate = async () => {
const { getTranslation } = apiTranslate;
const message = await getTranslation("hello world");
console.log(message); // ✅ 输出：Hello Welt
return message; // 可链式调用或用于后续逻辑
};
doTranslate();

3. 使用 IIFE（立即执行异步函数）——简洁适合顶层逻辑

(async () => {
const { getTranslation } = apiTranslate;
const message = await getTranslation("hello world");
console.log(message); // ✅ Hello Welt
})();

⚠️ 注意事项：

• ❌ 不要在顶层作用域（Top-level）直接 await getTranslation(...)（ES2024+ 支持 Top-level await，但需确保运行环境支持且模块类型为 module）；
• ❌ 避免 const message = getTranslation(...).then(...) —— 这仍赋值为 Promise，非结果；
• ✅ 始终将异步操作的消费逻辑（如渲染、存储、校验）置于 .then() 回调或 await 后续语句中；
• ✅ 生产环境中务必添加错误处理：

  try {
  const message = await getTranslation("hello world");
  console.log(message);
  } catch (err) {
  console.error("Translation failed:", err.response?.data || err.message);
  }

掌握 Promise 消费模式是前端异步编程的核心基础。记住：async 函数 ≠ 同步函数，它只是让异步流程写起来更像同步——但调度权仍在事件循环手中。