TypeScript Academy · 课时

satisfies 的实用模式

Q: 「satisfies 的实用模式」这节课中我会学到什么？

将 satisfies 应用于配置对象和查找表。 你通过在浏览器中直接运行的动手代码来练习 TypeScript Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

将 satisfies 应用于配置对象和查找表。

第 4 / 4 课13 个步骤

satisfies 的实用模式 是 CoddyKit 上的免费 TypeScript Academy 课时。这是第 4 节课，共 4 节。你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。这是 TypeScript Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 TypeScript Academy 课程共包含 4 节课。

验证颜色 palette

一种常见模式是使用 satisfies Record<string, Color> 定义 palette：每个值都会经过检查以确认是有效颜色，同时键仍保持精确，从而支持自动补全。

type Color = "red" | "green" | "blue";
const palette = {
  primary: "blue",
  secondary: "green"
} satisfies Record<string, Color>;
console.log(palette.primary);

捕获无效的 palette 值

如果某个值不是有效的 Color，satisfies 就会报错，而键仍会保持精确类型。

type Color = "red" | "green" | "blue";
// const bad = { primary: "purple" } satisfies Record<string, Color>; // Error
const ok = { primary: "red" } satisfies Record<string, Color>;
console.log(ok.primary);

保留键的自动补全

由于推断出的键是 "primary" | "secondary"，编辑器可以为它们提供自动补全；普通的 Record 注解则会丢失这些具体键。

type Color = "red" | "green" | "blue";
const palette = { primary: "red", accent: "blue" } satisfies Record<string, Color>;
// palette.<autocomplete: primary, accent>
console.log(palette.accent);

验证路由映射

路由映射同样受益：值必须符合处理程序结构，而路由名称会保持已知状态，以便导航辅助工具使用。

type Route = { method: "GET" | "POST"; path: string };
const routes = {
  home: { method: "GET", path: "/" },
  login: { method: "POST", path: "/login" }
} satisfies Record<string, Route>;
console.log(routes.login.method);

索引映射

保留键后，您可以构建有效路由名称的类型，并以类型安全的方式索引映射类型。

type Route = { method: string; path: string };
const routes = {
  home: { method: "GET", path: "/" },
  about: { method: "GET", path: "/about" }
} satisfies Record<string, Route>;
type RouteName = keyof typeof routes; // "home" | "about"
const pick: RouteName = "about";
console.log(routes[pick].path);

包含混合值的类型化 config

当值具有不同结构时，satisfies 同样有效。使用联合类型进行约束后，每个值都会根据该联合类型进行验证。

type Setting = number | boolean | string;
const config = {
  retries: 3,
  verbose: true,
  region: "eu"
} satisfies Record<string, Setting>;
console.log(config.retries, config.verbose);

类似枚举的查找表

构建一个根据值类型进行验证的查找表，同时为后续使用保留每个条目的精确类型。

type Status = "active" | "inactive";
const userStatus = {
  alice: "active",
  bob: "inactive"
} satisfies Record<string, Status>;
const s: "active" = userStatus.alice;
console.log(s);

与 as const 搭配使用

将 as const 与 satisfies 结合起来，可以得到深度不可变且经过验证的数据：as const 负责冻结数据，satisfies 负责检查数据。

type Color = "red" | "blue";
const theme = {
  primary: "red",
  secondary: "blue"
} as const satisfies Record<string, Color>;
console.log(theme.primary);

通过类型验证数值范围

您可以将值限制为数值字面量联合类型，以便表示固定的选项集合，并在定义时完成验证。

type Level = 1 | 2 | 3;
const levels = {
  easy: 1,
  medium: 2,
  hard: 3
} satisfies Record<string, Level>;
console.log(levels.hard);

功能开关映射

一种实用的功能开关 config：键是可以自动补全的开关名称，值则是由 satisfies 验证的布尔值。

const flags = {
  newDashboard: true,
  betaSearch: false
} satisfies Record<string, boolean>;
type Flag = keyof typeof flags;
const f: Flag = "betaSearch";
console.log(flags[f]);

这种模式为何更胜一筹

无论是 palette、路由还是 flags，satisfies Record<...> 都能提供经过验证的值，以及精确的键和字面量，是类型化配置日常使用中的理想方案。

type Color = "red" | "green" | "blue";
const ui = { brand: "green", warn: "red" } satisfies Record<string, Color>;
console.log(Object.keys(ui).join(","));

快速检查：实用的 satisfies

请测试您对 satisfies 实用模式的理解。

在交互式课程中回答

回顾：satisfies 的实用模式

您已将 satisfies Record<string, Color> 应用于 palette、路由映射、flags 和查找表，在验证每个值的同时保留精确的键和字面量，以支持自动补全。

type Color = "red" | "blue";
const theme = { bg: "blue", fg: "red" } satisfies Record<string, Color>;
console.log(theme.bg, theme.fg);

免费开始

用 AI 导师学习 TypeScript — 免费

在浏览器中编写并运行真实代码，获得全天候 AI 导师的即时帮助，并在网页或应用中继续学习。

课程: 101
课程: 352

免费开始学习查看完整课程

常见问题解答

「satisfies 的实用模式」课时是免费的吗？

是的 — 「satisfies 的实用模式」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 TypeScript Academy 课程的其余内容，请升级到 CoddyKit PRO。 TypeScript Academy 课程共包含 4 节课。

「satisfies 的实用模式」这节课中我会学到什么？

将 satisfies 应用于配置对象和查找表。你通过在浏览器中直接运行的动手代码来练习 TypeScript Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 TypeScript Academy 需要有经验吗？

无需任何先前经验。CoddyKit 上的 TypeScript Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。这是第 4 节课，共 4 节。

「satisfies 的实用模式」课时需要多长时间？

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。

我能在这节 TypeScript Academy 课中编写并运行代码吗？

能。每节 TypeScript Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

← 返回 TypeScript Academy