为什么这个值能赋过去:集合、子类型与结构类型
从赋值是否安全出发,建立类型的值集合模型,理解子类型、父类型、结构兼容和 unknown、never、any 的边界。
本章目录CONTENTS ↓
一个函数只接受字符串。传入固定文字 "ready" 没问题,传入“可能是字符串,也可能是数字”的变量却不行。另一个函数只要求对象有 name,带 name 和 id 的对象通常也能传入。它们看起来是不同规则,却都在回答一个问题:来源提供的信息,够不够满足目标的要求?
先用普通值和只读对象建立直觉,再说明 TypeScript 检查在哪些地方还需要额外规则。这样,后面的联合、泛型约束和条件判断就有共同的依据。
类型描述一组可能值
字符串字面量类型 "ready" 只允许这一种文字;string 还允许 "loading"、空字符串及其他字符串。所有符合前者的值都符合后者,因此前者的可能值范围包含在后者之中。
下面用变量展示赋值方向:
const ready: "ready" = "ready";const text: string = ready;
function asReady(input: string) { // @ts-expect-error string 还可能是其他文字 const exact: "ready" = input; return exact;}第一处赋值安全,因为目标只要求一个字符串,ready 一定满足。反方向不安全:input 可能是 "loading",目标却只允许 "ready"。判断方向时,要看来源声明允许的全部可能,而不能仅凭一次运行恰好是什么。
子类型与父类型不是类的家谱
在上述普通值模型中,如果 S 的每个可能值都符合 T,就称 S 是 T 的子类型(subtype),T 是 S 的父类型或超类型(supertype)。记作 S <: T;这是讲解关系的数学记号,不是 TS 语法。
“子”意味着更具体、限制更多;“父”意味着范围更宽、要求更少。父类型不等于更复杂的对象,子类型也不意味着必须写出 class 继承。前面的 "ready" <: string 根本不涉及类。
这种关系帮助判断是否能把 S 的值用在要求 T 的位置。但在实际 TypeScript 中,应区分两个层次:子类型是理解关系的模型;可赋值性(assignability)是编译器在具体场景中使用的检查规则,还受到特殊类型、函数规则、对象字面量及编译选项影响。不能把所有“编译通过”都解释为数学上的集合包含证明。
为什么字段更多,反而更具体
假设展示函数只读取 name:
type Named = { readonly name: string };type Identified = { readonly name: string; readonly id: number };
const account: Identified = { name: "Lin", id: 7 };const displayable: Named = account;
function requireId(value: Named) { // @ts-expect-error 只知道 name,不能保证还有 id const identified: Identified = value; return identified;}每个 Identified 都满足 Named 的 name 要求,但 Named 还允许没有 id 的值。增加一个必填字段,是增加必须满足的条件,因而缩小可接受值的范围。
TypeScript 的普通对象按结构检查,不要求两个类型名字相同,也不要求显式声明继承关系。这里用 readonly 排除通过这些属性写入的干扰;可变对象和数组还涉及共享引用与写入安全,不能仅凭这幅集合图推断所有赋值都绝对安全。
这也解释了后面看似矛盾的现象:交叉类型叠加字段要求,可能字段更多,符合要求的值却更少;联合放宽候选范围,反而只能直接依赖每个候选都提供的信息。下一章会完整推导。
新对象为什么还会检查多余字段
结构类型并不意味着任何写法都只检查必需属性。直接把新对象字面量赋给指定类型时,还会检查可疑的额外属性:
const existing = { name: "Lin", id: 7 };const accepted: Named = existing;// @ts-expect-error 新对象字面量中的 id 不属于目标声明const fresh: Named = { name: "Lin", id: 7 };两处的运行时对象结构相同,检查上下文却不同。额外属性检查能发现许多拼写和契约错误,但不会把 Named 变成“禁止一切其他字段”的精确对象类型。遇到这种报错,应先检查目标契约是否正确,不把中间变量当成逃避检查的通用办法。
unknown、never 与 any 放在哪里
对普通值的范围,可以先看两个端点:unknown 接受任何值,但在使用具体操作前要取得信息;never 没有可能值,适合表示不可能到达的分支或筛选后的空结果。
const opaque: unknown = "ready";// @ts-expect-error unknown 尚不保证是字符串const notYetText: string = opaque;
function readText(value: unknown): string { if (typeof value === "string") return value; throw new Error("需要字符串");}
function impossible(value: never): string { return value; // never 可赋给 string,但正常调用无法提供一个 never 值}unknown 的可接受范围很宽,可直接执行的操作却很少;“范围大”不等于“能力多”。never 没有成员,所以它加入普通联合不会增加候选:string | never 仍是 string。后面的条件筛选将利用这一点。
any 则不能当作一个普通的“最大集合”。它放宽许多检查,既能接收值,也常能被赋给具体类型;这种双向通过不代表类型相等,更不代表安全。
const unchecked: any = 42;const claimedText: string = unchecked; // 通过,但实际值仍是数字// claimedText.toUpperCase() 在运行时会失败,类型标注没有转换数值如果需要表达“暂时不知道,检查后再用”,选择 unknown;any 意味着放弃一部分静态保证。不要把上面例子的通过当作 number 是 string 子类型的证据。
同一个 extends,在不同位置做什么
后面会频繁遇到 extends。现在先区分它的角色,不必提前记住全部组合语法:
| 写法 | 回答的问题 |
|---|---|
interface Detailed extends Base |
在已有成员要求上继续声明结构。 |
T extends Base 出现在类型参数声明中 |
允许哪些类型作为参数 T? |
T extends Base ? X : Y 出现在类型表达式中 |
根据兼容关系选择哪一个输出? |
后两种都不表示 T 必须与 Base 完全相等。满足更多条件的具体类型,也可能符合较宽的约束。条件类型还可能逐个处理联合成员,细节留到条件与分配,不凭“像 if”就猜测它的运算单位。
函数还要看它怎样使用输入
若一个位置可能传入任意 Named,一个只接受 Identified 的函数就不能安全替换它:调用方可能没有 id。反过来,能处理 Named 的函数也能接住 Identified。这是后面参数逆变的出发点。返回结果则方向相反:承诺返回 Named 时,返回拥有更多信息的 Identified 通常足够。
完整推导与 TS 的函数检查例外放在函数兼容性。先记住判断方法:看调用方能提供什么,以及它依赖什么结果,不把对象赋值的方向机械套到每个函数位置。
本章例子使用 strict。值集合模型解释普通类型的包含关系;TS 为适应 JavaScript 还保留一些不能完全证明安全的兼容行为,所以它不是一套纯集合代数。官方资料:Type Compatibility、Excess Property Checks、unknown。继续阅读联合与交叉。
这一页,先记到这里。