首页 > 解决方案 > TypeScript:使用未知名称的字段声明类型或接口

问题描述

我必须为团队对象声明一个接口:

export interface Team{
  memberUid?: {
    mail: string
    name: string
    photoURL: string
  }
  startDate: Timestamp
  endDate: Timestamp
  agenda: Array<{
    date: Date | Timestamp
    title: string
    description: string
  }>
}

会有几个成员 Uids。我不知道如何在 TypeScript 中声明它。

我试过了:

[memberUid: string] : {
  mail: string
  name: string
  photoURL: string
}

但后来 TypeScript 明白 Team 中的所有字段都应该具有这种结构。

处理这个问题的正确方法是什么?

谢谢

标签: typescripttypescript-typingstypescript-types

解决方案


首先让我说我讨厌这种结构。如果有办法将代码重写为更合乎逻辑的Team类型,那就去做吧。但是能做到吗?是的,它可以。 Team但是必须是一个type而不是一个接口,因为接口只能有已知的键。

让我们先把它分成几块。

TeamBase 定义了始终存在的属性:

interface TeamBase {
  startDate: Timestamp
  endDate: Timestamp
  agenda: Array<{
    date: Date | Timestamp
    title: string
    description: string
  }>
}

UidProperties 定义了未知键的内容:

interface UidProperties {
    mail: string
    name: string
    photoURL: string
}

这是一个实用程序类型,可用于使用映射类型根据键的类型声明属性:

type HasProperty<Key extends keyof any, Value> = {
    [K in Key]: Value;
}

如果泛型Key是字符串文字,那么唯一可能的值K in Key就是那个确切的字符串,因此HasProperty<"myKey", string>解析为{ myKey: string; }

所以现在我们需要定义类型Team。我们知道它需要包含 的所有属性,TeamBase并且我们知道有一些字符串键的值是UidProperties。之前给您带来问题的一个重要事实是,该键不能是 TeamBase 的键之一。因此,我们不使用string,而是使用Exclude<string, keyof TeamBase>

您可以HasProperty<...>每个不是 TeamBase 的键的字符串键的值都是UidProperties,但我认为最好使用Partial<HasProperty<...>>表示这些未知字符串键中的任何一个可能是UidProperties但也可能是undefined。当您访问未知密钥时,您可能无论如何都需要仔细检查该值。

所以我们最终的 Team 类型是:

export type Team = TeamBase & Partial<HasProperty<Exclude<string, keyof TeamBase>, UidProperties>>

这按预期工作。因为我们已经允许未定义的可能性,所以如果不通过可选链接 with或语句等排除uid,您就不能访问属性。uidundefined?if

function f1(team: Team) {

    const startDate: Timestamp = team.startDate;

    const uid: UidProperties | undefined = team['randomKey']

    const name = uid?.name;

    if ( uid !== undefined ) {
        const mail = uid.mail;
    }
}

推荐阅读