JavaScript / TypeScript / 系统课时
固化字面量类型
固化字面量类型
TypeScript 有时会把具体值扩大为更宽泛的类型。使用 as const 可以保留字符串、数字和数组成员的精确字面量,并将对象属性和数组元素标记为只读,适合定义常量配置与精确联合类型。
学习目标
- 理解字面量类型被扩大的原因
- 使用
as const固化对象和数组的推断结果 - 从只读常量中提取精确联合类型
字面量为什么会被扩大
使用 let 声明变量时,变量后续可能被重新赋值,因此 TypeScript 通常会把 'draft' 推断为 string。对象属性默认也被视为可修改,属性值同样可能被扩大。
let status = 'draft';
const order = { status: 'draft' };
// status 和 order.status 都被推断为 string
status = 'paid';
order.status = 'cancelled';
console.log(status, order.status);预期输出:
paid cancelled如果程序需要把值限定为几个固定选项,宽泛的 string 会失去拼写检查和联合类型提示。此时可以使用 const 断言保留精确值。
使用 const 断言
在表达式末尾添加 as const 后,TypeScript 会执行三项处理:保留字面量类型、把对象属性设为只读、把数组推断为只读元组。它只影响类型检查,不会在运行时冻结对象。
const paymentMethods = ['card', 'wechat', 'alipay'] as const;
const config = {
currency: 'HKD',
retryCount: 3,
enabled: true
} as const;
type PaymentMethod = (typeof paymentMethods)[number];
function createPayment(method: PaymentMethod): void {
console.log(`创建支付:${method}`);
}
createPayment('wechat');
console.log(config.currency, config.retryCount, config.enabled);
// @ts-expect-error: 'cash' 不在只读元组成员中
createPayment('cash');
// @ts-expect-error: const 断言生成的属性不可重新赋值
config.currency = 'USD';预期输出:
创建支付:wechat
HKD 3 true
创建支付:cash最后两处错误由 @ts-expect-error 明确标记,因此示例仍可通过编译。该注释只验证编译期约束,不会删除对应 JavaScript 语句,所以运行后仍会输出 cash。
从常量提取联合类型
表达式 (typeof paymentMethods)[number] 可以拆成两步理解:typeof paymentMethods 获取只读元组类型,随后使用 [number] 取得所有数字索引位置上的成员类型。
本例最终得到的类型等价于:
type PaymentMethod = 'card' | 'wechat' | 'alipay';这是维护固定选项的常见方式。运行时数组可用于遍历或渲染,编译时联合类型可用于约束参数,两者来自同一份数据,不需要重复书写。
关键边界
as const 不是深度冻结工具。它会让当前表达式中的属性呈现递归只读效果,但不会阻止底层对象在其他引用处被修改,也不会调用 Object.freeze()。
const 断言应直接作用于字符串、数字、数组、对象等字面量表达式。对于需要继续修改的数据,不要过早添加 as const,否则后续更新会频繁遇到只读错误。
本课总结
as const可以阻止字面量被扩大,并生成只读属性或只读元组typeof 常量[number]能从只读数组中提取成员联合类型- const 断言只提供编译期约束,不等同于运行时冻结
下一课预告
下一课将使用 satisfies 校验对象是否符合目标结构,同时保留对象自身更精确的属性推断。