游戏引擎 / 系统课时
区分 unknown、any 和断言
区分 unknown、any 和断言
存档里的血量可能被写成字符串,类型断言却能让访问代码看起来完全合法。本节把外部 JSON 视为 unknown,通过真实字段校验得到可信角色数据,并对成功、结构错误与解析失败分别验证,避免把静态类型当成运行时安全保证。
学习目标
- 说明 unknown、any 与类型断言的检查差异。
- 对外部对象执行字段及数值范围校验。
- 为解析失败与数据非法提供可观察的结果。
三种写法保护的范围不同
any 会放宽后续检查,可以任意访问属性,错误也更容易扩散。unknown 允许接收任何值,但在读取字段前要求先证明类型。断言只是告诉编译器相信开发者,不会转换字符串、不补字段,也不检查 JSON 内容。外部数据默认使用 unknown 更符合实际可信程度。
JSON.parse 本身可能抛出语法错误,即使解析成功,也可能得到数组、null 或字段类型错误的对象。先验证容器,再验证必需字段,再验证业务范围,是一条可解释的检查路径。typeof null 是 object,所以容器判断必须排除 null。
在边界构造可信对象
文件:main.ts,完整纯 TypeScript 程序。
export {};
interface SaveData { id: string; hp: number; }
function readSave(text: string): SaveData {
const value: unknown = JSON.parse(text);
// 只接受普通对象形状,排除数组与 null。
if (typeof value !== 'object' || value === null || Array.isArray(value)) {
throw new Error('invalid object');
}
// 已确认对象容器;字典断言仅允许取出 unknown,不断言字段有效。
const data = value as Record<string, unknown>;
if (typeof data.id !== 'string' || data.id.length === 0
|| typeof data.hp !== 'number'
|| !Number.isFinite(data.hp) || data.hp < 0) {
throw new Error('invalid fields');
}
// 返回仅含协议字段的新对象,隔离无关外部字段。
return { id: data.id, hp: data.hp };
}
for (const text of ['{"id":"p1","hp":20}', '{"id":"p1","hp":"20"}', '{']) {
try {
const save = readSave(text);
console.log(`ok:${save.id}:${save.hp}`);
} catch (error: unknown) {
console.log(error instanceof SyntaxError ? 'parse failed'
: error instanceof Error ? error.message : 'unknown error');
}
}预期输出:
ok:p1:20
invalid fields
parse failed第二份 JSON 语法正确,但 hp 是字符串,因此属于数据非法;第三份甚至无法解析。把这两类失败分开,能分别提示“文件损坏”和“字段不符合版本”。不要在 catch 中直接访问 error.message,strict 环境下被捕获值也可能不是 Error 实例。
校验必须覆盖真正使用的字段
这里允许额外字段存在,但返回对象只保留 id 与 hp,避免下游无意依赖未知内容。如果存档版本要求禁止额外字段,还应明确检查字段集合。若业务要求 hp 必须为整数、不得超过角色上限,就在边界补上对应条件,而不是认为 number 已经包含这些含义。
数据一旦通过校验,后续函数可以使用 SaveData 协议,不必每次重复检查相同字段。可信范围应清楚:这份对象是本入口构造的,不等于整个外部响应都被验证,也不等于以后任何修改都安全。校验器返回新对象有助于缩小可信数据面。
断言留给确有证据的场合
断言适合开发者掌握编译器无法推导的信息时,但证据应来自真实条件、稳定接口或已完成的检查。连续写 as unknown as SaveData 只是压过不兼容检查,不会提供证据。优先让分支收窄类型,能使检查条件与使用位置在同一条数据流上。
练习输入 null、数组和负血量,确认分别进入容器或字段失败路径;再给合法对象加一个无关字段,观察结果仍只含协议内容。unknown 与断言规则依据 TypeScript unknown 和 类型断言说明。