JavaScript / TypeScript / 系统课时
字面量类型与 const
字面量类型与 const
TypeScript 不只会把值推断成 string、number 这类宽泛类型,还能把某个具体值本身作为类型。本篇通过 const、显式字面量类型与 as const,掌握什么时候会自动收窄,以及怎样保留对象和数组中的精确信息。
学习目标
- 理解字面量类型与普通基础类型的区别
- 判断
const声明何时会保留字面量、何时仍会发生类型拓宽 - 使用
as const收窄对象和数组,并理解它只影响类型检查
从具体值到字面量类型
字面量类型把“某一类值”进一步缩小为“某一个具体值”。例如类型 "GET" 只允许字符串 "GET",类型 200 只允许数字 200。它们通常与联合类型配合,用来表示一组有限、可枚举的合法状态。
const 声明的基本变量不能重新赋值,因此 TypeScript 通常会保留它的字面量类型;let 变量还可能变化,所以默认会拓宽为对应的基础类型。
// const 基础值不会再赋值,因此保留精确字面量
const fixedMethod = "GET";
// let 需要允许后续变化,所以默认拓宽为 string
let mutableMethod = "GET";
function acceptGet(method: "GET") {
console.log(`accepted: ${method}`);
}
acceptGet(fixedMethod);
console.log(typeof mutableMethod);预期输出:
accepted: GET
string这里 fixedMethod 的类型是 "GET",而 mutableMethod 的类型通常是 string。运行时二者都是普通字符串,差别只存在于 TypeScript 的静态类型检查阶段。
const 不等于对象属性不可变
const 只保证变量绑定不能改指向,并不会自动把对象内部的属性推断成字面量类型。对象属性本身仍可能被修改,因此 TypeScript 会为它们保留可变空间。
例如 const request = { method: "GET" } 中,request.method 默认通常是 string,而不是 "GET"。这也是为什么把它传给只接受 "GET" | "POST" 的接口时,可能需要更精确的类型声明。
用 as const 保留精确信息
as const 会让字面量表达式尽可能收窄:对象属性会变成 readonly,字符串和数字属性保留字面量类型,数组则会收窄为只读元组。
// as const 会同时收窄属性值,并让对象与数组获得只读类型
const request = {
method: "GET",
retry: 3,
headers: ["application/json"]
} as const;
// 参数只接受协议明确允许的方法
function send(method: "GET" | "POST") {
console.log(`${method} with retry=${request.retry}`);
}
send(request.method);
console.log(request.headers[0]);预期输出:
GET with retry=3
application/json此时 request.method 的类型是 "GET",request.retry 的类型是 3,request.headers 会被视为只读元组。这样既能保留配置对象的精确信息,又能直接用于依赖字面量联合类型的函数参数。
什么时候显式写字面量类型
如果变量允许重新赋值,但只允许在少数几个值之间切换,应显式声明字面量联合类型,例如 let status: "idle" | "loading" | "done" = "idle"。如果值本身固定,普通 const 往往已经足够;如果要让整个对象或数组都保留最精确的只读字面量信息,再使用 as const。
选择的关键不是“越窄越好”,而是让类型准确表达后续允许发生的变化:需要变化就保留合法变化范围,不需要变化才把类型收窄到具体字面量。