JavaScript / TypeScript / 系统课时

使用字面量类型

使用字面量类型

本课通过订单状态示例,把字符串、数字和布尔值限制为指定常量,避免业务字段接收任意内容,并理解字面量类型与联合类型的配合方式。

学习目标

  • 使用字符串、数字和布尔字面量声明固定值
  • 通过联合类型表达有限状态集合
  • 正确保留对象属性的字面量类型

字面量类型的作用

字面量类型表示变量只能接收某个具体值,而不是接收该基础类型的所有值。单个字面量通常与联合类型组合,用来描述状态、模式、等级等有限选项。

ts
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 后,执行:

bash
npx tsc literal-types.ts --target ES2020 --module commonjs && node literal-types.js

预期输出:

text
paid 2 true

字符串字面量适合状态、方向和运行模式;数字字面量适合有限等级或重试次数;布尔字面量通常用于表达必须为 true 或必须为 false 的约束。

限制业务状态

使用普通 string 时,任意文本都能传入函数,拼写错误通常只能在运行时发现。改成字面量联合后,非法值会在编译阶段被拒绝。

ts
type PaymentMethod = "card" | "wallet" | "bank";

function submitPayment(method: PaymentMethod): string {
  return `submit by ${method}`;
}

console.log(submitPayment("wallet"));

预期输出:

text
submit by wallet

下面是一个故意传入非法值的片段示例:

ts
submitPayment("cash");

预期结果:

text
Argument of type '"cash"' is not assignable to parameter of type 'PaymentMethod'.

字面量联合不仅能阻止错误,还能让编辑器准确提示所有合法选项。修改状态集合时,函数调用、条件判断和测试代码也会同步接受类型检查。

保留对象中的具体值

对象属性默认可能被拓宽为 string 或 number。需要保留具体字面量时,可以显式声明对象类型,也可以使用 as const 将整个对象推断为只读字面量结构。

ts
type Method = "card" | "wallet";

const request = {
  method: "card",
  retries: 1
} as const;

function send(method: Method): void {
  console.log(method);
}

send(request.method);

预期输出:

text
card

as const 会将 method 保留为字面量类型 "card",同时阻止属性被重新赋值。只需要限制少数字段时,显式类型注解通常更清晰;整个配置对象都应保持常量语义时,更适合使用 as const。

使用边界

字面量联合适合值集合较小且相对稳定的字段。合法值若来自接口、数据库或用户输入,运行时仍然需要校验,因为 TypeScript 类型在编译成 JavaScript 后不会继续存在。

不要手工维护特别长且频繁变化的字面量联合。值集合需要多处复用时,可以先定义常量对象,再从常量推导类型,减少运行时数据与类型声明不一致的问题。

本课总结

  • 字面量类型把变量限制为具体值,联合类型可以表达有限状态集合
  • 非法字面量会在编译阶段报错,并获得更准确的编辑器补全
  • as const 可以保留对象属性的具体值,但外部输入仍需运行时校验

下一课预告

下一课将继续处理数组、元组和对象类型,学习如何为一组值和结构化数据建立清晰约束。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

使用字面量类型

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通