TypeScript中如何允许非预期键？解决第三方键变量类型报错

你可以通过以下几种方式让TypeScript认可你对keyVariable取值范围的判断，无需添加无用键或忽略错误：

1. 类型断言直接缩小范围 #

直接将keyVariable断言为dataMap的有效键类型，明确告诉TS它只会是你预期的键值：

// 自动提取dataMap的有效键类型，避免手动维护
type ValidDataKey = keyof typeof dataMap;

const copy = {
  title: dataMap[keyVariable as ValidDataKey].label,
  info: dataMap[keyVariable as ValidDataKey].details,
};

2. 类型守卫（更安全的方案） #

如果想同时兼顾编译时类型检查和运行时安全，可以写一个类型守卫函数，验证keyVariable是否属于dataMap的有效键：

type ValidDataKey = keyof typeof dataMap;

// 类型守卫：返回true时，TS会将key的类型缩小为ValidDataKey
function isValidDataKey(key: unknown): key is ValidDataKey {
  return typeof key === 'string' && key in dataMap;
}

// 使用时先做校验
if (isValidDataKey(keyVariable)) {
  const copy = {
    title: dataMap[keyVariable].label,
    info: dataMap[keyVariable].details,
  };
  // 后续业务逻辑
} else {
  // 可选：处理意外键值的情况，比如抛错或打日志
  console.error(`Unexpected key: ${keyVariable}`);
  throw new Error(`Invalid key provided: ${keyVariable}`);
}

3. 定义类型别名约束第三方变量 #

如果这个keyVariable在多处使用，可以先给它定义一个缩小后的类型别名，再在代码中使用：

type ValidDataKey = keyof typeof dataMap;
// 将第三方变量的类型缩小为我们需要的范围
const safeKey = keyVariable as ValidDataKey;

const copy = {
  title: dataMap[safeKey].label,
  info: dataMap[safeKey].details,
};

这些方法都不需要修改dataMap的结构，也不用禁用TS的类型检查，完全符合你的需求。

内容的提问来源于stack exchange，提问作者Wasteland