JavaScript / TypeScript / 系统课时

处理未知异常

处理未知异常

本课解决 TypeScript 捕获异常时类型不安全的问题。通过将异常视为 unknown,并使用类型收窄判断真实类型,可以避免直接断言导致的运行时错误。

学习目标

  • 理解 catch 捕获异常时 unknown 类型的意义。
  • 掌握错误对象的安全判断方式。
  • 编写兼容不同异常来源的错误处理代码。

catch 中的异常类型

JavaScript 可以抛出任意值,不仅限于 Error 对象。因此 TypeScript 不应该默认认为捕获内容一定拥有 message 属性。

例如下面代码存在风险:

ts
try {
  throw "network failed";
} catch (error) {
  console.log(error.message);
}

预期结果

text
运行时错误:字符串没有 message 属性

开启严格模式后,catch 参数通常会被视为 unknown,开发者必须先判断类型。

使用类型收窄读取错误信息

处理异常时,推荐先判断对象类型,再访问对应属性。

ts
try {
  JSON.parse("invalid-json");
} catch (error: unknown) {
  if (error instanceof Error) {
    console.log(error.message);
  } else {
    console.log("未知错误");
  }
}

预期结果

text
Unexpected token i in JSON at position 0

instanceof Error 会帮助 TypeScript 将 unknown 收窄为 Error,从而安全访问 message、stack 等属性。

自定义错误判断

实际项目中,异常可能来自接口响应、第三方库或业务代码。可以通过类型守卫统一处理。

ts
function isError(value: unknown): value is Error {
  return value instanceof Error;
}

function printError(value: unknown) {
  if (isError(value)) {
    console.log(value.message);
  }
}

printError(new Error("failed"));

预期结果

text
failed

类型守卫可以复用复杂判断逻辑,让业务代码保持清晰。

避免不安全的类型断言

直接断言异常类型会绕过 TypeScript 检查:

ts
catch (error) {
  const message = (error as Error).message;
}

这种写法只有在确定异常来源时才适合使用。如果异常来自网络请求、插件或用户输入,应该优先使用类型收窄。

异常处理可以遵循以下顺序:先判断类型,再读取属性;无法确认类型时,提供通用错误提示。

本课总结

  • 捕获异常时不能假设错误一定是 Error 对象。
  • unknown 要求开发者通过类型判断后再使用数据。
  • 类型守卫比直接类型断言更适合复杂应用场景。

下一课预告

下一课将继续介绍 TypeScript 模块化组织方式,学习如何拆分文件、导入导出类型并维护大型项目结构。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

处理未知异常

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通