TypeScript-Exclude

---

前言

TypeScript 常用的类型 Exclude

Exclude 的词源

Exclude 是一个英语词汇，它的词源可以追溯到拉丁语。在英语中，exclude 的意思是“排除”、“排斥”或“阻止进入”。

词源分析

• Ex-: 这是一个拉丁语前缀，意为“out of”或“from”。
• Cludere: 这是拉丁语的一个词根，意为“to shut”或“to close”。

因此，exclude 的字面意思可以理解为“从外面关闭”或“不让进入”，引申义为“排除”或“拒绝加入”。

在 TypeScript 中的用法

在 TypeScript 中，Exclude<T, U> 是一个实用类型，用于从联合类型 T 中排除可以赋值给联合类型 U 的类型。换句话说，Exclude<T, U> 返回一个新的类型，该类型包含所有在 T 中但不在 U 中的类型成员。

语法

Exclude<T, U>

• T 是联合类型的原始类型。
• U 是要从中排除的类型的联合类型。

示例

假设我们有一个联合类型 AllTypes，它包含多种不同的类型，我们想要从中排除掉 string 类型：

type AllTypes = string | number | boolean | null;

type NonStringTypes = Exclude<AllTypes, string>;

在这个例子中，NonStringTypes 将是 number | boolean | null。

更复杂的示例

假设我们有一个更复杂的联合类型，其中包括多个类型，并且我们想要排除其中的某些类型：

type MixedTypes = string | number | boolean | null | undefined | object;

type ExcludeNullUndefined = Exclude<MixedTypes, null | undefined>;

在这个例子中，ExcludeNullUndefined 将是 string | number | boolean | object。

实际应用场景

Exclude 类型在实际开发中很有用，尤其是在需要从一个大的联合类型中排除某些特定类型的时候。例如，假设你有一个函数，它接收一个可以是多种类型的参数，但你不希望它接受 null 或 undefined：

type InputTypes = string | number | boolean | null | undefined;

function processInput(input: Exclude<InputTypes, null | undefined>) {
    // 处理 input
    console.log(input);
}

processInput("hello"); // 正确
processInput(42); // 正确
processInput(true); // 正确
processInput(null); // 错误
processInput(undefined); // 错误

在这个例子中，processInput 函数的参数类型是 string | number | boolean，因为我们使用 Exclude 排除了 null 和 undefined。

组合使用 Exclude 和其他类型

Exclude 类型还可以与其他类型一起使用，例如与 Pick、Omit、Partial 等类型结合使用，以创建更复杂的类型。

例如，假设我们有一个接口，我们想要排除某些属性：

interface Person {
    name: string;
    age: number;
    address: string;
    phoneNumber?: string;
}

type PartialPersonWithoutPhoneNumber = Exclude<Person, { phoneNumber?: string }> & Partial<Omit<Person, "phoneNumber">>;

const person: PartialPersonWithoutPhoneNumber = {
    name: "Alice",
    age: 30
};

// 下面的代码会报错，因为 phoneNumber 被排除了
// const invalidPerson: PartialPersonWithoutPhoneNumber = {
//     name: "Bob",
//     age: 25,
//     phoneNumber: "123-456-7890"
// };

在这个例子中，PartialPersonWithoutPhoneNumber 类型排除了 phoneNumber 属性，并允许其他属性为可选。

总结

Exclude<T, U> 类型是一个非常有用的工具，可以帮助你在 TypeScript 中创建更精细和精确的类型。通过排除不需要的类型，你可以更好地控制你的类型系统，并使代码更加健壮和类型安全。