JavaScript / TypeScript / 系统课时
使用字面量类型
使用字面量类型
本课通过订单状态示例,把字符串、数字和布尔值限制为指定常量,避免业务字段接收任意内容,并理解字面量类型与联合类型的配合方式。
学习目标
- 使用字符串、数字和布尔字面量声明固定值
- 通过联合类型表达有限状态集合
- 正确保留对象属性的字面量类型
字面量类型的作用
字面量类型表示变量只能接收某个具体值,而不是接收该基础类型的所有值。单个字面量通常与联合类型组合,用来描述状态、模式、等级等有限选项。
type OrderStatus = "pending" | "paid" | "cancelled";
type RetryCount = 0 | 1 | 2 | 3;
type FeatureEnabled = true;
let status: OrderStatus = "pending";
let retries: RetryCount = 0;
const enabled: FeatureEnabled = true;
status = "paid";
retries = 2;
console.log(status, retries, enabled);将代码保存为 literal-types.ts。项目安装 TypeScript 后,执行:
npx tsc literal-types.ts --target ES2020 --module commonjs && node literal-types.js预期输出:
paid 2 true字符串字面量适合状态、方向和运行模式;数字字面量适合有限等级或重试次数;布尔字面量通常用于表达必须为 true 或必须为 false 的约束。
限制业务状态
使用普通 string 时,任意文本都能传入函数,拼写错误通常只能在运行时发现。改成字面量联合后,非法值会在编译阶段被拒绝。
type PaymentMethod = "card" | "wallet" | "bank";
function submitPayment(method: PaymentMethod): string {
return `submit by ${method}`;
}
console.log(submitPayment("wallet"));预期输出:
submit by wallet下面是一个故意传入非法值的片段示例:
submitPayment("cash");预期结果:
Argument of type '"cash"' is not assignable to parameter of type 'PaymentMethod'.字面量联合不仅能阻止错误,还能让编辑器准确提示所有合法选项。修改状态集合时,函数调用、条件判断和测试代码也会同步接受类型检查。
保留对象中的具体值
对象属性默认可能被拓宽为 string 或 number。需要保留具体字面量时,可以显式声明对象类型,也可以使用 as const 将整个对象推断为只读字面量结构。
type Method = "card" | "wallet";
const request = {
method: "card",
retries: 1
} as const;
function send(method: Method): void {
console.log(method);
}
send(request.method);预期输出:
cardas const 会将 method 保留为字面量类型 "card",同时阻止属性被重新赋值。只需要限制少数字段时,显式类型注解通常更清晰;整个配置对象都应保持常量语义时,更适合使用 as const。
使用边界
字面量联合适合值集合较小且相对稳定的字段。合法值若来自接口、数据库或用户输入,运行时仍然需要校验,因为 TypeScript 类型在编译成 JavaScript 后不会继续存在。
不要手工维护特别长且频繁变化的字面量联合。值集合需要多处复用时,可以先定义常量对象,再从常量推导类型,减少运行时数据与类型声明不一致的问题。
本课总结
- 字面量类型把变量限制为具体值,联合类型可以表达有限状态集合
- 非法字面量会在编译阶段报错,并获得更准确的编辑器补全
as const可以保留对象属性的具体值,但外部输入仍需运行时校验
下一课预告
下一课将继续处理数组、元组和对象类型,学习如何为一组值和结构化数据建立清晰约束。