第92章 unknown类型
案例题目
从外部API接收一个unknown类型的数据(可能是任何内容),编写一个安全的解析函数,将未知输入转换为可信的对象数据,并在处理过程中使用类型守卫进行逐层验证。
设计思路
利用unknown类型的特性——必须先进行类型缩小才能操作,设计三个守卫函数:isRecord、isUser、parseUser。通过逐步收窄,把任意输入安全转换为强类型对象,避免运行时错误。
✅ 核心代码
// 类型守卫:检查是否为对象(非null、非数组)
function isRecord(value: unknown): value is Record<string, unknown> {
return typeof value === 'object' && value !== null && !Array.isArray(value);
}
// 类型守卫:检查是否为字符串
function isString(value: unknown): value is string {
return typeof value === 'string';
}
// 类型守卫:检查是否为数字
function isNumber(value: unknown): value is number {
return typeof value === 'number' && isFinite(value);
}
// 定义User接口
interface User {
id: number;
name: string;
email: string;
}
// 安全解析函数
function parseUser(data: unknown): User {
if (!isRecord(data)) {
throw new Error('顶层必须是对象');
}
const { id, name, email } = data;
if (!isNumber(id) || !isString(name) || !isString(email)) {
throw new Error('字段类型不匹配');
}
return { id, name, email };
}
// 测试
try {
const validData: unknown = { id: 1, name: '张三', email: 'zhang@example.com' };
console.log('成功:', parseUser(validData));
} catch (e) {
console.error((e as Error).message);
}
▶️ 运行结果
运行上述代码,控制台输出:成功: { id: 1, name: '张三', email: 'zhang@example.com' }。如果传入{ id: '1', name: '张三', email: 'zhang@example.com' },则会抛出"字段类型不匹配"错误。
💎 测试建议
分别传入:null(触发"顶层必须是对象")、{ id: '2', name: '李四', email: 'li@example.com' }(触发类型错误)、以及合法数据(成功返回)。
⚠️ 注意事项
unknown禁止直接访问属性或调用方法,必须先通过typeof、instanceof或自定义守卫缩小类型。使用any会绕过类型系统,完全失去保护。
🏁 成功要点
掌握了unknown的安全处理模式:类型守卫 + 逐层收窄。这使得外部数据在运行时被严格验证,同时保持编译期的类型安全。