JavaScript / TypeScript / 系统课时
处理外部未知数据
处理外部未知数据
接口响应、配置文件和用户输入即使“看起来像”某个 TypeScript 类型,也仍然只是运行时数据。本节建立一条明确边界:外部值先按 unknown 接收,完成结构校验后,再交给业务代码使用。
学习目标
- 理解类型断言为什么不能替代运行时数据验证
- 使用
unknown、类型守卫和显式解析函数收窄外部数据 - 区分 JSON 语法错误与业务字段结构错误
类型系统不能替代运行时校验
TypeScript 的类型只在编译阶段工作,程序运行后不会自动检查接口对象。value as User 只是在告诉编译器“相信我”,它不会验证 id 是否真是数字,也不会检查必填字段是否存在。因此,断言适合表达开发者已经掌握的类型事实,不适合证明不受信任数据是安全的。
安全边界的核心规则是:外部数据进入程序时保持未知,校验成功后才获得业务类型。这样一旦接口字段漂移、第三方返回异常值或缓存里混入旧结构,错误会停在解析层,而不是在更深的业务逻辑里变成难以定位的异常。
从 unknown 收窄为业务类型
下面用一个最小解析函数处理用户数据。JSON.parse 的结果显式赋给 unknown,随后通过属性检查构造 User。
type User = {
id: number;
name: string;
email: string;
};
function isRecord(value: unknown): value is Record<string, unknown> {
return typeof value === "object" && value !== null;
}
function parseUser(input: unknown): User {
// 外部数据必须先通过结构检查,不能直接断言成 User。
if (
!isRecord(input) ||
typeof input.id !== "number" ||
typeof input.name !== "string" ||
typeof input.email !== "string"
) {
throw new Error("接口数据格式不符合 User 约定");
}
// 校验成功后重新构造业务对象,避免把未知字段继续带入业务层。
return { id: input.id, name: input.name, email: input.email };
}
const payload = '{"id":7,"name":"Ada","email":"ada@example.com"}';
const raw: unknown = JSON.parse(payload);
const user = parseUser(raw);
console.log(`${user.id}: ${user.name} <${user.email}>`);预期输出
7: Ada <ada@example.com>parseUser 的返回类型是 User,所以调用方从这里开始可以安全获得属性补全和静态检查。若字段缺失或类型错误,函数会在边界处抛出异常,而不会返回一个“编译器相信、运行时却不成立”的对象。
把两类失败分开处理
外部 JSON 常见失败有两层。第一层是文本本身不是合法 JSON,此时 JSON.parse 会抛出语法错误;第二层是 JSON 合法,但字段不符合业务约定,此时应由 parseUser 这类校验函数报告结构错误。实际接口层可以统一捕获两类异常,再转换成日志、错误响应或重试策略。
当字段很多、存在嵌套对象、联合类型或复杂规则时,手写守卫会迅速变长。此时可以使用专门的运行时校验库定义 schema,并从 schema 推导静态类型;但无论使用什么工具,都应保留同一个边界原则:先验证真实数据,再相信 TypeScript 类型。