JavaScript / TypeScript / 系统课时
使用 keyof 与 typeof
使用 keyof 与 typeof
当对象结构已经存在时,再手写一份属性名联合或接口容易产生重复和不同步。本课使用 typeof 提取变量的静态类型,再用 keyof 得到合法键名,让类型声明直接跟随实际代码变化。
学习目标
- 使用
typeof从变量或函数中提取类型 - 使用
keyof生成对象键名的联合类型 - 组合两者编写类型安全的属性读取函数
typeof 在类型位置的作用
JavaScript 中的 typeof value 会在运行时返回 "string"、"number" 等文本;TypeScript 在类型位置使用 typeof 时,则会取得某个变量的静态类型。
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);预期输出
db.example.com
6432Config 会被推导为包含 host: string、port: number 和 secure: boolean 的对象类型。之后对象结构发生变化时,只需修改源对象,派生类型会自动更新。
keyof 提取合法键名
keyof 接收一个对象类型,并产生该类型所有公开键名组成的联合类型。对 Config 使用 keyof,结果等价于 "host" | "port" | "secure"。
type ConfigKey = keyof Config;
const firstKey: ConfigKey = "host";
const secondKey: ConfigKey = "secure";
console.log(firstKey);
console.log(secondKey);
// const invalidKey: ConfigKey = "timeout"; // 编译错误预期输出
host
secure只要源对象增加或删除属性,ConfigKey 就会同步变化,不再需要维护另一份字符串联合。
组合 keyof 与 typeof
两者最常见的组合是:先从对象提取类型,再限制函数只能接收真实存在的键,并根据键返回准确的值类型。
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 不是合法键预期输出
ANYSTACK
4appName 被推导为 string,而 retries 被推导为 number。这比返回 string | number | boolean 更精确,也避免调用方进行类型断言。
关键边界
typeof 只能引用当前作用域中可见的标识符,不能在类型位置直接执行任意表达式。例如,应先把表达式结果赋给变量,再对变量使用 typeof。
对象字面量默认会把 "localhost" 推导为 string。若确实需要保留字面量值和只读属性,可在对象后添加 as const;但这会让派生类型更严格,复制对象时也必须满足相同字面量值,使用前应确认是否符合需求。
keyof 作用于类型,而不是直接作用于运行时对象。常见写法是 keyof typeof someObject,它把“提取对象类型”和“提取该类型的键”合并为一步。
本课总结
- 类型位置的
typeof用于复用已有变量的静态类型 keyof会把对象属性名转换为联合类型keyof typeof object可让键名和对象结构自动保持同步
下一课预告
下一课将继续学习映射类型,批量把对象属性转换为可选、只读或其他新形态。