0Pricing
TypeScript Academy · 课时

错误类型（unknown）与 catch 中的收窄

将 catch 参数标注为 unknown，然后使用 instanceof/typeof 或自定义守卫进行收窄，以安全处理错误。

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

简介

目标：将错误捕获为 unknown 并安全地进行收窄。您将使用 instanceof、typeof 和自定义类型守卫读取错误数据，避免意外情况。

unknown 与 instanceof

从 unknown 开始。使用 instanceof Error 进行收窄，以访问 message、stack 等内容。

async function boom(): Promise<void> { throw new Error("boom") }

async function run() {
  try {
    await boom();
  } catch (e: unknown) {
    if (e instanceof Error) {
      console.error("Handled:", e.message);
    } else {
      console.error("Non-Error thrown:", e);
    }
  }
}

run();

使用 typeof 处理基本类型

有些代码会抛出字符串或其他基本类型。使用 typeof 进行收窄并妥善处理。

function throwString() { throw "bad" }

try {
  throwString();
} catch (e: unknown) {
  if (typeof e === "string") {
    console.warn("string error:", e.toUpperCase());
  } else {
    console.warn("other error", e);
  }
}

自定义守卫

创建用户定义的类型守卫，以识别来自不同层的“类似错误”结构。

type ErrorLike = { message: string; code?: string };

function isErrorLike(e: unknown): e is ErrorLike {
  return !!e && typeof e === "object" && "message" in e;
}

try {
  throw { message: "oops", code: "E_BAD" };
} catch (e: unknown) {
  if (isErrorLike(e)) {
    console.error(e.message, e.code ?? "no-code");
  } else {
    console.error("unknown error", e);
  }
}

安全记录日志

集中处理错误。一个小型辅助函数可以进行收窄并安全地记录日志，避免日志记录本身导致崩溃。

function logErrorSafe(e: unknown): void {
  if (e instanceof Error) {
    console.error("Error:", e.message);
  } else if (typeof e === "string") {
    console.error("Error(string):", e);
  } else {
    try {
      console.error("Error(obj):", JSON.stringify(e));
    } catch {
      console.error("Error(unknown)");
    }
  }
}

try { throw { oops: true } } catch (e: unknown) { logErrorSafe(e) }

提示

提示：

  • 在 catch 中优先使用 unknown。
  • 使用 instanceof、typeof 或守卫进行收窄。
  • 避免假定错误一定是 Error——第三方代码可能抛出任何内容。

错误类型检查

快速检查：为什么在 catch 中优先使用 unknown？

回顾

回顾：将错误捕获为 unknown，使用 instanceof/typeof 或自定义守卫进行收窄，并集中进行安全的日志记录。

常见问题解答

「错误类型（unknown）与 catch 中的收窄」课时是免费的吗？

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

「错误类型（unknown）与 catch 中的收窄」这节课中我会学到什么？

将 catch 参数标注为 unknown，然后使用 instanceof/typeof 或自定义守卫进行收窄，以安全处理错误。 你通过在浏览器中直接运行的动手代码来练习 TypeScript Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 TypeScript Academy 需要有经验吗？

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

「错误类型（unknown）与 catch 中的收窄」课时需要多长时间？

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

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

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

此课程中的所有课时

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