JavaScript / TypeScript / 系统课时
模板字面量类型
模板字面量类型
模板字面量类型把字符串字面量与联合类型组合成一组可检查的字符串规则。本节用事件名、API 路径和状态标识构造约束,让拼写错误和非法组合在编译阶段暴露,而不是等到运行时再排查。
学习目标
- 掌握模板字面量类型的基本组合语法
- 能用联合类型生成事件名、路径和状态标识
- 理解组合数量扩大和类型过宽时的边界
字符串类型也可以被组合
模板字面量类型的语法与 JavaScript 模板字符串相似,但它运行在类型系统中。${A}:${B} 会把 A、B 的所有字面量成员进行组合;如果两边都是联合类型,结果就是这些成员的笛卡尔组合。
例如 type Entity = "user" | "order" 与 type Action = "created" | "deleted" 组合后,可以得到 "user:created" | "user:deleted" | "order:created" | "order:deleted"。这比直接使用 string 更能表达允许值的边界。
用类型约束事件名与路径
下面的示例同时约束事件名、API 路径和状态标识。函数参数仍然是普通字符串值,但只有符合类型模式的字符串才能通过编译。
type Entity = "user" | "order";
type Action = "created" | "deleted";
type EventName = `${Entity}:${Action}`;
type ApiPath = `/api/${Entity}/${number}`;
type Status = `status_${"idle" | "loading" | "success" | "error"}`;
function emit(event: EventName): void {
console.log(`event=${event}`);
}
function report(path: ApiPath, status: Status): void {
console.log(`${path} ${status}`);
}
emit("user:created");
report("/api/order/42", "status_success");预期输出(将代码保存为 template-demo.ts,使用 npx tsc --strict --target ES2020 --module commonjs template-demo.ts && node template-demo.js 编译并运行):
event=user:created
/api/order/42 status_success如果把事件名写成 "user:updated",或把路径写成 "api/order/42",都会在编译阶段失败,因为它们不满足已经声明的字符串模式。
和内置字符串工具一起使用
模板字面量类型经常与 Uppercase、Lowercase、Capitalize、Uncapitalize 配合。例如对 "name" | "age" 使用 Capitalize 会得到 "Name" | "Age",再在模板字面量中添加 get 前缀,就能得到 "getName" | "getAge"。
这类组合适合从一组稳定字段推导事件名、Getter 名、CSS 变体或协议标识。核心价值不是“生成字符串”,而是让多个地方共享同一套命名规则,减少手工重复维护。
注意组合规模与过宽类型
联合类型成员越多,模板字面量展开后的组合数增长越快。假设三个位置分别有 10、10、20 个候选值,理论上就可能产生 2000 个字符串成员。组合巨大时,编辑器提示和类型检查都会变重,此时更适合保留较宽的字符串类型,并把部分约束交给运行时校验。
另一个常见问题是某一段被写成普通 string。例如 ${string}:${Action} 的左半部分已经完全放开,类型就失去了枚举实体名的能力。设计这类类型时,应优先让真正稳定、有限的维度保持字面量联合,只把天然开放的片段交给 string 或 ${number}。
模板字面量类型最适合表达“格式稳定、取值空间可控”的命名协议。事件名、路由片段和状态键一旦由同一组基础联合类型推导,新增成员时只需修改源类型,相关字符串约束会自动同步更新。