JavaScript / TypeScript / 系统课时
使用模板字面量类型
使用模板字面量类型
当字符串必须遵循固定命名规则时,手写联合类型容易遗漏。模板字面量类型可以把已有键名或联合类型拼接成新的字符串联合,让事件名、字段路径和接口标识在编译阶段就受到约束。
学习目标
- 理解模板字面量类型如何拼接字符串联合
- 根据对象键名生成事件名和字段路径
- 识别宽泛字符串、非字符串键与联合数量膨胀等边界
模板字面量类型的规则
模板字面量类型写在反引号中,并通过 ${类型} 插入字符串字面量联合。若插入位置是联合类型,TypeScript 会对每个成员分别展开;多个位置都是联合时,则会生成它们的笛卡尔组合。
例如,"name" | "age" 放入 ${Key}Changed 后,会得到 "nameChanged" | "ageChanged"。这类类型只存在于编译阶段,不会在运行时自动创建字符串。
主示例:生成事件名与字段路径
下面从 UserForm 的字符串键生成两组固定格式字符串。keyof UserForm & string 会排除可能出现的数字键或符号键,只保留可安全拼接的字符串键。
interface UserForm {
name: string;
age: number;
}
type StringKey<T> = keyof T & string;
type ChangeEvent<T> = `${StringKey<T>}Changed`;
type FieldPath<T> = `form.${StringKey<T>}`;
const events: ChangeEvent<UserForm>[] = [
"nameChanged",
"ageChanged",
];
const paths: FieldPath<UserForm>[] = [
"form.name",
"form.age",
];
// 固定格式之外的字符串会被编译器拒绝
// @ts-expect-error
const invalidEvent: ChangeEvent<UserForm> = "nameUpdated";
for (const value of [...events, ...paths]) {
console.log(value);
}预期输出:
nameChanged
ageChanged
form.name
form.age示例中的错误赋值不会进入运行结果;@ts-expect-error 用于确认该行确实应当产生类型错误。删除这条注释后,编译器会直接报告 "nameUpdated" 不能赋给目标联合类型。
关键边界
模板中的插值类型应尽量保持为有限联合。若使用普通 string,结果通常会退化为宽泛字符串格式,例如 ${string}Changed,只能约束后缀,无法枚举具体成员。
当多个插值位置都包含较大联合时,成员数量会快速增长。此时应缩小输入联合、拆分类型,或改用运行时校验,避免编辑器提示和类型检查明显变慢。
内置的 Uppercase、Lowercase、Capitalize 和 Uncapitalize 可以继续转换字符串成员,例如 Capitalize<"name" | "age"> 会得到 "Name" | "Age"。
本课总结
- 模板字面量类型能把已有联合拼接成固定格式的字符串联合
keyof T & string适合从对象字符串键生成事件名或字段路径- 插值联合过大或退化为
string时,应重新评估类型复杂度
下一课预告
下一课将使用 Partial、Pick、Record 和 ReturnType 等内置工具类型,在不重复声明结构的前提下复用并转换现有类型。