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 0instanceof 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 模块化组织方式,学习如何拆分文件、导入导出类型并维护大型项目结构。
按自己的节奏,确认真正理解。