TypeScript 中Omit 工具类型的实用技巧

type NewType = Omit<OriginalType, 'propToExclude1' | 'propToExclude2'>;

interface User {
  id: number;
  name: string;
  email: string;
  isAdmin: boolean;
  createdAt: Date;
}

type UserProfile = Omit<User, 'email' | 'isAdmin'>;

// 此时，UserProfile 类型等同于：
// {
//   id: number;
//   name: string;
//   createdAt: Date;
// }

const userProfile: UserProfile = {
  id: 1,
  name: 'Alice',
  createdAt: new Date(),
};
// userProfile.email; // 类型错误：属性“email”在类型“UserProfile”上不存在。

interface Article {
  id: string;
  title: string;
  content: string;
  authorId: number;
  views: number;
  createdAt: Date;
  updatedAt: Date;
}

// 创建文章时，不需要提交 id, views, createdAt, updatedAt
type CreateArticlePayload = Omit<Article, 'id' | 'views' | 'createdAt' | 'updatedAt'>;

// CreateArticlePayload 类型为:
// {
//   title: string;
//   content: string;
//   authorId: number;
// }

function submitNewArticle(payload: CreateArticlePayload) {
  // ...提交逻辑
  console.log(payload.title);
}

submitNewArticle({
  title: 'Understanding Omit in TypeScript',
  content: 'Omit is a powerful utility type...',
  authorId: 101,
});

interface UserAccount {
  userId: string;
  username: string;
  email: string;
  passwordHash: string; // 敏感信息
  internalFlags: string; // 内部信息
  isActive: boolean;
}

// 定义一个公开的用户信息类型，不包含 passwordHash 和 internalFlags
type PublicUserInfo = Omit<UserAccount, 'passwordHash' | 'internalFlags'>;

// PublicUserInfo 类型为:
// {
//   userId: string;
//   username: string;
//   email: string;
//   isActive: boolean;
// }

function getUserInfoForClient(account: UserAccount): PublicUserInfo {
  // 实际实现中，你可能需要手动挑选属性或使用库
  // 但类型定义确保了返回对象的结构是正确的
  return {
    userId: account.userId,
    username: account.username,
    email: account.email,
    isActive: account.isActive,
  };
}

interface Product {
  sku: string;
  name: string;
  price: number;
  description: string;
}

// 尝试 Omit 一个不存在的属性 'descripton' (拼写错误)
// type ProductSummary = Omit<Product, 'descripton' | 'sku'>;
// TypeScript 编译器会报错:
// Type '"descripton"' does not satisfy the constraint 'keyof Product'.

// 正确的写法
type ProductSummary = Omit<Product, 'description' | 'sku'>;
// ProductSummary 类型为:
// {
//   name: string;
//   price: number;
// }

interface Config {
  readonly id: string;
  apiKey: string;
  timeout: number;
  debugMode: boolean;
}

// 假设我们想创建一个可修改部分配置的类型，但不允许修改 id，并且 debugMode 是可选的
// 1. 先 Omit掉 id
type ConfigWithoutId = Omit<Config, 'id'>;
// ConfigWithoutId = { apiKey: string; timeout: number; debugMode: boolean; }

// 2. 再将 debugMode 设为可选
type UpdateConfigPayload = Partial<Pick<ConfigWithoutId, 'debugMode'>> & Omit<ConfigWithoutId, 'debugMode'>;
// 或者更简洁地，如果目标是让部分属性可选，同时排除其他属性：
type ModifiableConfig = Omit<Partial<Config>, 'id'>;
// ModifiableConfig = { apiKey?: string; timeout?: number; debugMode?: boolean; }
// 注意：这种组合方式需要仔细考虑最终生成的类型结构是否符合预期。

// 一个更常见的组合：创建一个类型，其中某些属性被省略，其余属性变为可选
type OptionalEditableUser = Partial<Omit<User, 'id' | 'createdAt'>>;
// OptionalEditableUser 类型为:
// {
//   name?: string;
//   email?: string;
//   isAdmin?: boolean;
// }