JavaScript / TypeScript / 系统课时

使用 keyof 与 typeof

使用 keyof 与 typeof

当对象结构已经存在时,再手写一份属性名联合或接口容易产生重复和不同步。本课使用 typeof 提取变量的静态类型,再用 keyof 得到合法键名,让类型声明直接跟随实际代码变化。

学习目标

  • 使用 typeof 从变量或函数中提取类型
  • 使用 keyof 生成对象键名的联合类型
  • 组合两者编写类型安全的属性读取函数

typeof 在类型位置的作用

JavaScript 中的 typeof value 会在运行时返回 "string"、"number" 等文本;TypeScript 在类型位置使用 typeof 时,则会取得某个变量的静态类型。

ts
const defaultConfig = {
  host: "localhost",
  port: 5432,
  secure: false
};

type Config = typeof defaultConfig;

const productionConfig: Config = {
  host: "db.example.com",
  port: 6432,
  secure: true
};

console.log(productionConfig.host);
console.log(productionConfig.port);

预期输出

text
db.example.com
6432

Config 会被推导为包含 host: string、port: number 和 secure: boolean 的对象类型。之后对象结构发生变化时,只需修改源对象,派生类型会自动更新。

keyof 提取合法键名

keyof 接收一个对象类型,并产生该类型所有公开键名组成的联合类型。对 Config 使用 keyof,结果等价于 "host" | "port" | "secure"。

ts
type ConfigKey = keyof Config;

const firstKey: ConfigKey = "host";
const secondKey: ConfigKey = "secure";

console.log(firstKey);
console.log(secondKey);

// const invalidKey: ConfigKey = "timeout"; // 编译错误

预期输出

text
host
secure

只要源对象增加或删除属性,ConfigKey 就会同步变化,不再需要维护另一份字符串联合。

组合 keyof 与 typeof

两者最常见的组合是:先从对象提取类型,再限制函数只能接收真实存在的键,并根据键返回准确的值类型。

ts
const appConfig = {
  name: "Anystack",
  retryCount: 3,
  debug: true
};

type AppConfig = typeof appConfig;

function readConfig<K extends keyof AppConfig>(
  key: K
): AppConfig[K] {
  // 返回类型会随 key 自动变化
  return appConfig[key];
}

const appName = readConfig("name");
const retries = readConfig("retryCount");

console.log(appName.toUpperCase());
console.log(retries + 1);

// readConfig("version"); // 编译错误:version 不是合法键

预期输出

text
ANYSTACK
4

appName 被推导为 string,而 retries 被推导为 number。这比返回 string | number | boolean 更精确,也避免调用方进行类型断言。

关键边界

typeof 只能引用当前作用域中可见的标识符,不能在类型位置直接执行任意表达式。例如,应先把表达式结果赋给变量,再对变量使用 typeof。

对象字面量默认会把 "localhost" 推导为 string。若确实需要保留字面量值和只读属性,可在对象后添加 as const;但这会让派生类型更严格,复制对象时也必须满足相同字面量值,使用前应确认是否符合需求。

keyof 作用于类型,而不是直接作用于运行时对象。常见写法是 keyof typeof someObject,它把“提取对象类型”和“提取该类型的键”合并为一步。

本课总结

  • 类型位置的 typeof 用于复用已有变量的静态类型
  • keyof 会把对象属性名转换为联合类型
  • keyof typeof object 可让键名和对象结构自动保持同步

下一课预告

下一课将继续学习映射类型,批量把对象属性转换为可选、只读或其他新形态。

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

目录与阅读设置

阅读设置

17

记录一个想法

使用 keyof 与 typeof

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

登录哪都通