JavaScript / TypeScript / 系统课时
satisfies 运算符
satisfies 运算符
本课解决“既要检查对象符合目标类型,又不想丢失具体属性类型”的问题。你将比较类型注解与 satisfies 的差异,并掌握配置表、路由表等对象的安全写法。
学习目标
- 理解
satisfies的检查行为 - 保留对象属性的精确推断结果
- 区分
satisfies、类型注解与类型断言
校验而不改写结果类型
satisfies 会检查表达式是否满足目标类型,但不会像普通类型注解那样把表达式的最终类型直接替换为目标类型。
// 检查统一契约,仍保留各属性可用的方法
type ConfigKey = "home" | "retry";
const config = {
home: "/dashboard",
retry: 3,
} satisfies Record<ConfigKey, string | number>;
console.log(config.home.toUpperCase());
console.log(config.retry.toFixed(0));预期输出:
/DASHBOARD
3检查完成后,config.home 仍被识别为字符串,config.retry 仍被识别为数字,因此可以直接调用各自的方法。同时,漏写 retry、多写未知键或填入布尔值都会报错。
与类型注解比较
type ConfigKey = "home" | "retry";
const annotated: Record<ConfigKey, string | number> = {
home: "/dashboard",
retry: 3,
};
// annotated.home 的类型是 string | number这是类型声明片段。普通注解让两个属性都表现为 string | number,调用字符串方法前还需要缩小类型。satisfies 更适合“对象本身需要精确推断,同时必须满足统一契约”的情况。
与 as 断言比较
as Target 主要告诉编译器“按目标类型看待这个值”,可能掩盖不安全结构;satisfies Target 负责验证,不会把不匹配的值强行视为正确。需要保留字面量到最窄范围时,可组合 as const satisfies Target。
type RouteName = "home" | "profile";
type Route = { path: `/${string}`; secure: boolean };
const routes = {
home: { path: "/", secure: false },
profile: { path: "/profile", secure: true },
} as const satisfies Record<RouteName, Route>;这是类型声明片段。routes.profile.path 会保留为字面量 "/profile",整个对象同时接受 Route 结构检查。
校验范围与推断细节
satisfies 自 TypeScript 4.9 起可用,本课使用 5.9.3。它仍参与上下文类型检查,不能简单说表达式推断在所有场景完全不受影响;应观察具体属性类型。当前例子保留字符串与数字的区别,因此各自的方法可调用。
在对象字面量中漏写 retry、增加未知键或放入布尔值,应产生编译错误。先把对象放入另一个变量再校验时,还要考虑结构类型的多余属性规则,不能把 satisfies 当成通用的运行时精确字段校验器。
as const 保留只读和字面量类型,但不会执行 Object.freeze,也不会验证外部 JSON。路径必须以斜杠开头的规则来自模板字面量类型,检查只覆盖经过编译的源码。接口或配置文件运行时加载时仍须验证数据。4.9 发布说明 解释了该运算符的设计目标。
独立验证
使用 TypeScript 5.9.3 和 Node.js 22 检查本节。主配置的两个属性应分别支持字符串和数值方法。把 retry 改为 true,应在 satisfies 校验处失败;路由片段单独编译,避免重复声明同名类型。把主示例保存为独立目录的 main.ts,执行 npx tsc main.ts --strict --target ES2022 --module commonjs --outDir dist,预期退出码为 0;再执行 node dist/main.js 核对上述结果。说明性片段按其上下文编译,练习目录保持 CommonJS 模块约定。