re:re:actable
Урок 011 минута чтения

Что такое Utility Types в TypeScript?

На этой странице
Кратко

Utility Types - это встроенные типы-помощники, которые преобразуют уже существующие типы: делают поля опциональными, выбирают часть полей, исключают варианты union и так далее.

Вопрос

Что такое Utility Types в TypeScript?

Зачем они нужны

Utility-типы позволяют не дублировать похожие типы вручную.

type User = {
  id: number;
  name: string;
  email: string;
};
 
type UserDraft = Partial<User>;
type UserPreview = Pick<User, "id" | "name">;

Если исходный User изменится, производные типы обновятся автоматически.

Популярные utility-типы

type OptionalUser = Partial<User>;
type RequiredUser = Required<User>;
type ReadonlyUser = Readonly<User>;
type UserName = Pick<User, "name">;
type UserWithoutEmail = Omit<User, "email">;

Utility для union

type Status = "idle" | "loading" | "success" | "error";
 
type Finished = Exclude<Status, "idle" | "loading">;
// "success" | "error"
 
type OnlyLoading = Extract<Status, "loading" | "pending">;
// "loading"

Utility для функций

function createUser(name: string, age: number) {
  return { name, age };
}
 
type Params = Parameters<typeof createUser>;
type Result = ReturnType<typeof createUser>;

Что важно помнить

  • Utility-типы встроены в TypeScript и описаны в lib.es5.d.ts.
  • Основная группа: Partial, Required, Readonly, Pick, Omit, Record, Exclude, Extract, NonNullable, ReturnType, Parameters, Awaited.
  • Почти все построены на mapped и conditional types — их полезно уметь реализовать самому.
  • Дополнительные утилиты есть в библиотеке type-fest.

Мини-шпаргалка

  • Utility Types преобразуют существующие типы.
  • Partial, Required, Readonly меняют свойства.
  • Pick, Omit, Record помогают собирать объектные типы.
  • Exclude, Extract, ReturnType, Parameters работают с union и функциями.

Документация

TypeScript: Utility Types, type-fest.

Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.

Поиск

Поиск по урокам