0Pricing
TypeScript Academy · 课时

Promise<T> 与 async/await 类型

理解 Promise 的结构，为异步函数添加类型，并安全地处理 await 后的值。

Promise<T> 与 async/await 类型 是 CoddyKit 上的免费 TypeScript Academy 课时。 这是第 1 节课，共 3 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 TypeScript Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 TypeScript Academy 课程共包含 3 节课。

简介

目标：读写基于 Promise<T> 的代码。您将为异步函数添加类型、等待值，并为错误保留类型信息。

Promise 基础

Promise<T>包装一个最终会得到的值。当没有值需要解析时，请使用 Promise。

function delay(ms: number): Promise<void> {
  return new Promise(resolve => setTimeout(resolve, ms));
}

const p: Promise<void> = delay(100);

p.then(() => console.log("done"));

async 返回类型

async 函数始终返回 Promise<U>。函数体返回 U，TS 会自动将其包装起来。

async function fetchNumber(): Promise<number> {
  await delay(10);
  return 42; // inferred as Promise<number>
}

fetchNumber().then(n => console.log(n.toFixed(0)));

await 类型

await 会解包 Promise 并得到其内部类型（这里是 string），因此您可以获得正确的 IntelliSense。

async function readUserName(id: number): Promise<string> {
  await delay(5);
  return `user-${id}`;
}

async function main(): Promise<void> {
  const name = await readUserName(7); // name: string
  console.log(name.toUpperCase());
}

main();

Promise.all 类型

Promise.all 会保留元组类型；每个元素都会自动等待并转换为其内部类型。

async function both() {
  const [n, s] = await Promise.all([
    fetchNumber(),
    readUserName(1),
  ]);
  console.log(n, s);
}

both();

错误类型

在 catch 中，优先使用 unknown。访问字段前，请使用 instanceof Error（或自定义检查）进行收窄。

async function safe() {
  try {
    await delay(1);
    throw new Error("boom");
  } catch (e: unknown) {
    if (e instanceof Error) {
      console.error("Handled:", e.message);
    } else {
      console.error("Unknown error", e);
    }
  }
}

safe();

异步返回类型检查

快速检查：返回类型为 U 的值的异步函数，其返回类型是什么？

回顾

回顾：Promise<T> 会包装最终值，async 函数返回 Promise<U>，await 会解包类型，而 catch 中的错误应先视为 unknown。

常见问题解答

「Promise<T> 与 async/await 类型」课时是免费的吗？

是的 — 「Promise<T> 与 async/await 类型」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 TypeScript Academy 课程的其余内容，请升级到 CoddyKit PRO。 TypeScript Academy 课程共包含 3 节课。

「Promise<T> 与 async/await 类型」这节课中我会学到什么？

理解 Promise 的结构，为异步函数添加类型，并安全地处理 await 后的值。 你通过在浏览器中直接运行的动手代码来练习 TypeScript Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 TypeScript Academy 需要有经验吗？

无需任何先前经验。CoddyKit 上的 TypeScript Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。 这是第 1 节课，共 3 节。

「Promise<T> 与 async/await 类型」课时需要多长时间？

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。

我能在这节 TypeScript Academy 课中编写并运行代码吗？

能。每节 TypeScript Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

  1. Promise 与 async/await 类型
  2. 错误类型（unknown）与 catch 中的收窄
  3. 并发模式（all/settled/race）的类型
← 返回 TypeScript Academy