第90章 类型断言与转换
案例90:类型断言与转换——显式转换不同类型
题目:在处理来自外部API的未知数据结构时,需要将 unknown 类型安全地转换为具体类型,并处理转换失败的情况。
设计思路
通过类型断言(as)与自定义类型守卫函数,实现从 unknown 到 User 接口的安全转换。利用 typeof 和 in 运算符在运行时验证数据结构,避免盲目断言导致的运行时错误。
核心代码
interface User {
id: number;
name: string;
age?: number;
}
// 类型守卫:判断是否为合法User
function isUser(data: unknown): data is User {
if (typeof data !== 'object' || data === null) return false;
const obj = data as Record<string, unknown>;
return typeof obj.id === 'number' && typeof obj.name === 'string';
}
// 显式转换函数
function toUser(data: unknown): User {
if (isUser(data)) {
return data; // 此处通过守卫后自动收窄为User
}
throw new Error('数据格式不合法,无法转换为User');
}
// 模拟外部数据
const rawData: unknown = { id: 1, name: '张三', age: 25 };
const user = toUser(rawData);
console.log('转换成功:', user.id, user.name, user.age);
// 错误场景演示
try {
const badData: unknown = { id: 'abc', name: 42 };
toUser(badData);
} catch (e) {
console.log('捕获错误:', (e as Error).message);
}
运行结果
转换成功: 1 张三 25
捕获错误: 数据格式不合法,无法转换为User
验证方法
直接运行 ts-node 案例90.ts 或使用 tsc 编译后运行。修改 rawData 的字段类型,观察守卫函数是否正确拦截错误数据。
注意事项
类型断言不会改变运行时数据类型,只能辅助编译器。对于API返回的 unknown 数据,务必先使用类型守卫验证,避免使用双重断言 as unknown as 绕过类型检查。
成功要点
类型守卫(data is User)是实现安全转换的关键,它通过运行时检查将类型收窄,确保后续代码访问属性时不会产生异常。