成功就必须有数据:判别联合
让成功与失败数据形成合法配对,排除缺失信息和交叉组合。
本章目录CONTENTS ↓
请求成功时必须有数据,失败时必须有错误。若只写一个布尔状态,再给 data 和 error 都加上问号,编译器会允许“成功但没有数据”。我们需要表达的不是三个独立字段,而是两组完整的合法组合。
为什么独立可选字段不够
type User = { name: string };type LooseResult = { ok: boolean; data?: User; error?: string };const allowedButIncomplete: LooseResult = { ok: true };LooseResult 允许成功却缺少数据,说明它没有表达业务规则。检查 ok 后,data 仍可能不存在,编译器的报错是对模型的准确反馈。
类似地,{ kind: "login" | "progress"; data: LoginData | ProgressData } 把两个字段的选择独立开放,会允许交叉组合。需要配对时,应把每组合法组合放进同一个联合成员,再让成员形成联合。
可选属性适用于字段确实能够独立缺省的场景;判别联合适用于某个状态决定其他字段要求的场景。
用完整状态表达业务规则
先分别写出成功与失败的完整形状,再用联合连接。下面的 T 是成功数据类型的占位参数;写 Result<User> 时,相应位置使用 User。这是泛型最简单的用途,后面的泛型章会解释约束与推导,这里只需跟踪这一次替换。
type Result<T> = | { ok: true; data: T } | { ok: false; error: string };
function display(result: Result<User>): string { if (result.ok) return `你好,${result.data.name}`; return `加载失败:${result.error}`;}
const success: Result<User> = { ok: true, data: { name: "Lin" } };const failure: Result<User> = { ok: false, error: "网络不可用" };// @ts-expect-error 成功成员必须携带 dataconst incomplete: Result<User> = { ok: true };// @ts-expect-error 失败成员不能只提供成功数据const crossed: Result<User> = { ok: false, data: { name: "Lin" } };Result 描述两个完整成员。ok 的字面量值区分成员,检查它便同时确定对应的数据要求。T 让同一套状态规则适用于不同成功数据,不需要为每种实体重写成功与失败结构。
从模型边界看工程取舍
这种模型保证成功数据与状态匹配,但不会验证服务器返回的数据,也不是禁止所有额外属性的“精确对象”。TypeScript 通常按结构检查;已经存在的对象可能携带契约之外的信息。如果业务要求严格字段集合,必须另外定义和验证。
真实页面还可能有 idle、loading 等状态。可以继续为每种状态定义完整成员,并用 switch 消费;新增状态时,可用 never 做穷尽检查。不要把所有状态都塞进一个宽泛对象,再依赖调用方记住哪些字段此刻有效。
错误结构也应根据来源选择:已经标准化的展示错误可以是 string;捕获 JavaScript 异常时,通常先保留 unknown,再检查。后一种设计见函数包装。
阅读与应用
设计完以后,用“缺失必需数据”和“交叉配对”各构造一个非法例子,确认编译器拒绝它们;再看消费代码能否自然收窄。静态用例验证模型允许什么,运行时测试验证程序实际做了什么。
机制见类型收窄,官方入口为 Discriminated Unions。更多关联模型见表单字段变更,阅读路线见全景。
这一页,先记到这里。