字段与值不能错配:生成变更联合
从表单值类型生成更新消息,保留字段和值的对应关系并限制可编辑范围。
本章目录CONTENTS ↓
表单里的 title 接受字符串,enabled 接受布尔值。更新消息若把 field 写成所有字段名、value 写成所有字段值的联合,就会允许“把 title 改成 true”。手写每组配对能排除这种错误,却难以跟随表单变化。
这次把映射与索引组合起来:先为一个字段构造完整配对,再对指定的可编辑键重复这个过程,最后取出这些成员的联合。业务已经给定可编辑范围,本章负责把范围和对应关系编码成类型。
从一份表单定义生成更新契约
type FormValues = { title: string; count: number; enabled: boolean };
type ChangesFor<T, Keys extends keyof T = keyof T> = { [K in Keys]: { field: K; value: T[K] }}[Keys];
type FieldChange = ChangesFor<FormValues>;type EditableChange = ChangesFor<FormValues, "title" | "enabled">;
const titleChange: EditableChange = { field: "title", value: "新标题" };const enabledChange: EditableChange = { field: "enabled", value: true };// @ts-expect-error title 只能接收 stringconst wrongValue: EditableChange = { field: "title", value: 3 };// @ts-expect-error count 没有进入可编辑范围const readOnlyChange: EditableChange = { field: "count", value: 3 };输入是表单类型 T 和允许编辑的键集合 Keys。泛型默认值使省略 Keys 时使用全部键;约束保证选中的键确实属于 T。映射逐个生成完整的字段和值配对,最后用 Keys 取出成员联合。
追踪一次变换
| 当前 K | 生成的成员 |
|---|---|
"title" |
{ field: "title"; value: string } |
"enabled" |
{ field: "enabled"; value: boolean } |
两者组成 EditableChange。当前 K 同时用于 field 和 T[K],是关联得以保留的原因。
若把值写成 T[keyof T],每个字段都会接受 string、number、boolean;若映射只生成 Keys 范围内的属性,却用 keyof T 取值,就可能访问中间对象不存在的键。读取范围应与构造结果相符。
消费更新消息
function describeChange(change: EditableChange): string { if (change.field === "title") { return `标题改为 ${change.value.trim()}`; } return change.value ? "已启用" : "已关闭";}字段检查会同时确定 value,因为它们属于同一个联合成员。这里展示消息消费,不实现通用对象更新器;动态赋值能否保留关联,还取决于具体函数体,不能仅凭消息类型成立就假定所有索引写入都能通过。
选用这种模型的时机
事件队列、变更日志、跨组件消息需要把一次修改保存为独立数据时,这种联合很合适。如果只是在明确位置写一次 form.title = text,直接赋值可能更简单;如果要同时修改多个字段,部分对象补丁又是另一种契约,需要定义缺省、删除与校验语义。
本例限定必填普通属性。可选字段可能需要区分“设置 undefined”“删除字段”和“不修改字段”;不应只复制一个类型公式而跳过这些业务选择。
下一步可把相同模式用于事件参数配对和API 测试条目。机制回查:映射与索引;官方入口:Mapped Types、Generic Parameter Defaults。回到全景。
这一页,先记到这里。