TypeScript参数解构与空值合并的类型报错问题

问题描述 #

使用参数解构结合空值合并操作时，TypeScript对可选的name属性抛出类型报错。不想将代码修改为const name = data?.resource?.name ?? []（该写法可解决报错），希望通过调整TypeScript配置或类型定义，适配当前的解构写法。

代码示例 #

private _getName(data: Data) {
    const { name } = data.resource ?? [];
}

类型定义 #

type Data = {
    fullUrl?: string,
    resource?: {
      active?: boolean,
      address?: Address[],
      birthDate?: string,
      gender?: string,
      id?: string,
      identifier?: Indentifier[],
      materialStatus?: Coding[],
      meta?: Security[],
      name?: Name[],
      resourceType?: string,
      telecom?: Telecom[],
    },
    search?: {
      extension?: Extension[],
      mode?: string,
      score: number,
    }
};

错误信息 #

error TS2339: Property 'name' does not exist on type '{ active?: boolean; address?: Address[]; birthDate?: string; gender?: string; id?: string; identifier?: Indentifier[]; materialStatus?: Coding[]; meta?: Security[]; name?: Name[]; resourceType?: string; telecom?: Telecom[]; } | undefined[]'.

73     const { name } = data.resource ?? []

解决方法 #

1. 修改空值合并的默认值（推荐） #

报错核心原因是data.resource ?? []的结果为resource类型或空数组，而空数组不存在name属性。将默认值从[]改为空对象，让默认值结构与resource类型兼容：

// 解构后name类型为Name[]|undefined
const { name } = data.resource ?? {};

// 若需要name默认是空数组，可在解构时直接指定默认值
const { name = [] } = data.resource ?? {};

2. 调整TypeScript配置（不推荐） #

关闭strictNullChecks配置可绕过当前类型检查，但会降低整个项目的类型安全性，可能引入其他潜在问题。在tsconfig.json中修改：

{
  "compilerOptions": {
    "strictNullChecks": false
  }
}

3. 使用类型断言兜底 #

若能确定默认值结构安全，可通过类型断言强制指定类型，但需自行保证代码逻辑的正确性：

const { name } = (data.resource ?? {}) as NonNullable<Data['resource']>;

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