0Pricing
TypeScript Academy · 课时

收窄捕获的错误：unknown 与 Error

安全地处理类型为 unknown 的捕获错误

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

欢迎

从 TypeScript 4.0 开始，捕获的错误类型为 unknown。这要求您在使用错误属性之前进行显式缩小。

TS 4.0 的变化

TypeScript 4.0 引入了 useUnknownInCatchVariables。在严格模式下，捕获的错误类型为 unknown。
// err is now: unknown
try { doSomething(); }
catch (err) {
  // err.message; // Error — cannot access on unknown
}

使用 instanceof 进行缩小

使用 instanceof Error 安全地访问错误属性。
catch (err) {
  if (err instanceof Error) {
    console.error(err.message, err.stack);
  } else {
    console.error('Unknown error:', String(err));
  }
}

isError 类型守卫

创建可复用的类型守卫，以缩小错误类型。
function isError(e: unknown): e is Error {
  return e instanceof Error;
}
catch (e) {
  if (isError(e)) console.error(e.message);
}

自定义错误缩小

在 catch 代码块中将类型缩小为自定义错误类型。
catch (err) {
  if (err instanceof NetworkError) { /* retry */ }
  else if (err instanceof AuthError) { /* redirect */ }
  else if (err instanceof Error) { /* generic */ }
  else throw err;
}

useUnknownInCatchVariables

此标志（TS 4.4 及更高版本中 strict 的一部分）会强制将捕获的错误设为 unknown。
{ "compilerOptions": { "useUnknownInCatchVariables": true } }

字符串错误

有些代码会抛出字符串，而不是 Error 对象。请同时处理这两种情况。
catch (err) {
  const message = err instanceof Error ? err.message : String(err);
  console.error(message);
}

带类型的抛出辅助函数

创建一个始终抛出带类型 Error 的辅助函数。
function throwErr(msg: string, code = 500): never {
  const e: AppError = Object.assign(new Error(msg), { statusCode: code });
  throw e;
}

重新抛出未知错误

重新抛出您无法处理的错误。
catch (err) {
  if (err instanceof KnownError) handle(err);
  else throw err; // propagate unknowns
}

React 中的错误边界

React 错误边界必须处理生命周期方法产生的未知错误。
componentDidCatch(error: unknown, info: ErrorInfo) {
  if (error instanceof Error) logError(error.message);
}

测试捕获的错误

使用带类型的断言测试错误处理。
test('catches errors', async () => {
  jest.spyOn(api, 'fetch').mockRejectedValue(new NetworkError());
  const result = await safeRun();
  expect(result.ok).toBe(false);
});

快速检查

在 TypeScript 4.4 及更高版本的严格模式下，捕获的错误 `err` 的类型是什么？

回顾

缩小捕获的错误类型（unknown 与 Error）：您已经学习了本主题的关键概念，以及如何在实际 TypeScript 项目中应用它们。

常见问题解答

「收窄捕获的错误：unknown 与 Error」课时是免费的吗？

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

「收窄捕获的错误：unknown 与 Error」这节课中我会学到什么？

安全地处理类型为 unknown 的捕获错误 你通过在浏览器中直接运行的动手代码来练习 TypeScript Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 TypeScript Academy 需要有经验吗？

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

「收窄捕获的错误：unknown 与 Error」课时需要多长时间？

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

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

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

此课程中的所有课时

  1. 带类型的错误类与层次结构
  2. Result 模式：Ok 与 Err
  3. 收窄捕获的错误：unknown 与 Error
  4. 异步 TypeScript 代码中的错误处理
← 返回 TypeScript Academy