请问能否介绍一下utility-types库的用途呢？

Question

发现一个点赞很高的库utility-types，没有看明白为何这么受欢迎。

请问能否介绍一下它的用途呢？

Answer 1

针对 ts 类型的 lodash，类似的还有 type-fest、ts-toolbelt、hotscript

Answer 2

utility-types 是一个 TypeScript 库，它提供了一组实用工具类型，用于增强和简化 TypeScript 类型定义。通过使用这些工具类型，开发者可以更方便地操作和管理复杂的类型，减少重复代码，并提高代码的可读性和可维护性。

主要功能

utility-types 提供了许多常用的工具类型，以下是一些关键的功能和用途：

1. 类型变换和操作

   • PartialDeep<T>: 将类型 T 中所有属性递归地设为可选。
   • ReadonlyDeep<T>: 将类型 T 中所有属性递归地设为只读。
   • RequiredDeep<T>: 将类型 T 中所有属性递归地设为必选。
   • NonNullable<T>: 去除类型 T 中所有可能为 null 或 undefined 的属性。

2. 对象属性操作

   • Pick<T, K>: 从类型 T 中选择部分属性，构造一个新的类型。
   • Omit<T, K>: 从类型 T 中排除部分属性，构造一个新的类型。
   • Record<K, T>: 构造一个类型，属性名为类型 K 的属性，属性值为类型 T。
   • Merge<M, N>: 合并两个对象类型 M 和 N，如果存在冲突，后者 N 的属性将覆盖前者 M 的属性。

3. 其他实用工具

   • DeepReadonly<T>: 将类型 T 中的所有属性递归地设为只读。
   • DeepPartial<T>: 将类型 T 中的所有属性递归地设为可选。
   • Writable<T>: 移除类型 T 中的 readonly 修饰符。
   • DeepWritable<T>: 递归地移除类型 T 中的 readonly 修饰符。

典型用例

在日常开发中，utility-types 可以帮助你：

简化类型定义：例如，使用 PartialDeep<T> 可以将一个复杂对象的所有属性都设为可选，而不需要手动去做这件事。
增强类型安全性：使用 ReadonlyDeep<T> 可以确保对象及其所有嵌套属性都无法被修改，提供更强的不可变性保障。
高效操作类型：通过 Omit<T, K> 可以快速创建新类型，仅保留需要的属性。

示例代码

import { PartialDeep, ReadonlyDeep } from 'utility-types';

type User = {
  name: string;
  age: number;
  address: {
    street: string;
    city: string;
  };
};

// PartialDeep: 将 User 类型递归设为可选
const partialUser: PartialDeep<User> = {
  address: {
    city: 'New York',
  },
};

// ReadonlyDeep: 将 User 类型递归设为只读
const readonlyUser: ReadonlyDeep<User> = {
  name: 'Alice',
  age: 30,
  address: {
    street: '123 Main St',
    city: 'New York',
  },
};

// readonlyUser.name = 'Bob'; // Error: Cannot assign to 'name' because it is a read-only property.

Answer 3

来自 ChatGPT。

piotrwitek/utility-types 是一个 TypeScript 库，它提供了一组实用的类型（utility types），用于简化和增强 TypeScript 类型的使用。这个库扩展了 TypeScript 内置的实用类型，并添加了一些额外的功能，使开发者能够更轻松地操作和管理复杂的类型结构。

以下是 utility-types 库的主要用途和功能：

1. 扩展 TypeScript 内置实用类型

• utility-types 提供了一些 TypeScript 中没有的类型。例如，DeepPartial<T>、DeepReadonly<T> 等，它们允许递归地对对象的所有嵌套属性进行部分化或只读化。

2. 类型转换和操作

• 库中包含一些类型转换的工具类型，比如 Intersection<T, U>（交集类型），可以创建由两个类型的公共属性组成的新类型。
• NonNullableKeys<T> 和 NullableKeys<T> 类型，分别可以获取对象中非可空（Non-Nullable）和可空（Nullable）的键集合。

3. 条件类型操作

• 使用条件类型可以轻松实现类型过滤和选择。例如，OmitByValue<T, V> 可以从类型 T 中排除掉所有值类型为 V 的属性。

4. 增强类型推断

• utility-types 提供了一些有助于改进类型推断的工具，比如 Overwrite<T, U>，可以用类型 U 中的属性覆盖类型 T 中的属性。

5. 创建更具表现力的类型

• 库中包含许多帮助创建更复杂和表现力更强的类型工具，如 Promisify<T>，可以将一个普通的函数类型转为返回 Promise 的函数类型。

示例

import { DeepPartial, Omit } from 'utility-types';

interface User {
  id: number;
  name: string;
  address: {
    street: string;
    city: string;
  };
}

// 使用 DeepPartial 将 User 类型中的所有属性变为可选的
type PartialUser = DeepPartial<User>;

// 使用 Omit 去掉 User 类型中的 'id' 属性
type UserWithoutId = Omit<User, 'id'>;

总结

piotrwitek/utility-types 是一个强大的库，它补充了 TypeScript 本身的类型系统，特别适合在处理复杂的类型结构时使用。通过使用这个库，开发者可以更加灵活和高效地操作类型，从而编写更具可读性和安全性的代码。