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

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

为什么拿到的不是结果，而是 Promise

在用 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/v2key=${_API_KEY}`,
{ q: text, target: "de" }
);
const translation = res.data.data.translations[0].translatedText;
console.log(translation); //  正确输出：Hello Welt
return translation; //  实际返回：Promise<“Hello Welt”>
}

因此，这行代码：

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 函数 ≠ 同步函数。它只是让异步流程写起来更像同步，但调度权仍在事件循环手中。