Utility Types разбор

TypeScript предоставляет богатый набор встроенных utility types. Разберём самые важные.

Работа со свойствами объектов

interface User {
  id: number
  name: string
  email: string
  password: string
  createdAt: Date
}

// Pick<T, K> — берём только указанные поля
type PublicUser = Pick<User, 'id' | 'name' | 'email'>
// { id: number, name: string, email: string }

// Omit<T, K> — убираем указанные поля
type SafeUser = Omit<User, 'password'>
// { id: number, name: string, email: string, createdAt: Date }

// Partial<T> — все поля опциональны
type UpdateUserDto = Partial<Omit<User, 'id' | 'createdAt'>>
// { name?: string, email?: string, password?: string }

// Required<T> — все поля обязательны
type FullUser = Required<User>

// Readonly<T> — все поля readonly
type ImmutableUser = Readonly<User>

Работа с union типами

type Status = 'active' | 'inactive' | 'banned' | 'deleted'

// Extract<T, U> — оставляем только совместимые с U
type ActiveStatuses = Extract<Status, 'active' | 'inactive'>
// 'active' | 'inactive'

// Exclude<T, U> — убираем совместимые с U
type ValidStatuses = Exclude<Status, 'deleted'>
// 'active' | 'inactive' | 'banned'

// NonNullable<T> — убираем null и undefined
type Defined = NonNullable<string | null | undefined>
// string

Record<K, V>

// Record<K, V> — словарь с ключами K и значениями V
type StatusMessages = Record<Status, string>
const messages: StatusMessages = {
  active: 'Активен',
  inactive: 'Неактивен',
  banned: 'Заблокирован',
  deleted: 'Удалён'
}

// Полезно с keyof
type UserFields = Record<keyof User, string>
// Все поля User, но значения — строки

Типы функций

function createUser(name: string, age: number, admin?: boolean): User {
  return { id: 1, name, email: '', password: '', createdAt: new Date() }
}

// ReturnType<T> — тип возвращаемого значения
type CreateUserResult = ReturnType<typeof createUser>  // User

// Parameters<T> — кортеж типов параметров
type CreateUserArgs = Parameters<typeof createUser>
// [name: string, age: number, admin?: boolean]

// Пример использования Parameters
function logged<T extends (...args: any[]) => any>(fn: T) {
  return function(...args: Parameters<T>): ReturnType<T> {
    console.log('Вызов с аргументами:', args)
    const result = fn(...args)
    console.log('Результат:', result)
    return result
  }
}

Полный список utility types