TypeScript中无法修改接口时如何访问unknown类型对象属性？

由于CoolInterface中的field3被定义为unknown类型，TypeScript无法推断其内部结构，直接访问result.field3[0].map['uri']会触发类型错误。在无法修改原接口的前提下，可通过以下几种方式解决：

1. 类型断言（Type Assertion） #

如果能确定field3的实际数据结构，可以直接通过类型断言告诉TypeScript其具体类型，快速实现属性访问：

// 定义匹配field3实际结构的类型
type Field3Item = {
  map: {
    uri: string;
  };
};

const result: CoolInterface = getData(input);
// 断言field3为目标类型的数组，之后即可安全访问深层属性
const hasString = ((result.field3 as Field3Item[])[0].map['uri']).includes('some-string');

注意：类型断言不会做运行时检查，如果实际数据结构与断言不符，会导致运行时错误，仅适用于数据结构确定的场景。

2. 类型守卫（Type Guards） #

如果需要运行时安全性，可以编写类型守卫函数，通过检查数据结构来缩小类型范围，避免潜在的运行时错误：

const result: CoolInterface = getData(input);

// 自定义类型守卫，判断值是否符合目标结构
function isValidField3(value: unknown): value is { map: { uri: string } }[] {
  // 先检查是否为数组
  if (!Array.isArray(value)) return false;
  // 检查数组首个元素（或所有元素，按需调整）的结构
  const firstItem = value[0];
  return (
    typeof firstItem === 'object' &&
    firstItem !== null &&
    'map' in firstItem &&
    typeof firstItem.map === 'object' &&
    firstItem.map !== null &&
    'uri' in firstItem.map &&
    typeof firstItem.map.uri === 'string'
  );
}

// 类型守卫通过后，TypeScript会自动推断field3的类型
if (isValidField3(result.field3)) {
  const hasString = result.field3[0].map['uri'].includes('some-string');
  // 后续可安全使用hasString
} else {
  // 处理数据结构不符合预期的情况
  console.error('field3结构不符合预期');
}

3. 可选链 + 类型检查结合 #

考虑到field3是可选字段（带有?），可能存在undefined的情况，可结合可选链操作符和类型检查，进一步提升代码健壮性：

const result: CoolInterface = getData(input);

// 用可选链处理可能的undefined/null，再检查uri的类型
const uri = result.field3?.[0]?.map?.uri;
if (typeof uri === 'string') {
  const hasString = uri.includes('some-string');
}

这种方式无需显式断言，通过TypeScript的类型窄化自动识别uri为字符串类型，同时避免了深层访问时的空值报错。

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