字段与值不能错配:生成变更联合

从表单值类型生成更新消息,保留字段和值的对应关系并限制可编辑范围。

本章目录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 只能接收 string
const 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。回到全景。

这一页,先记到这里。