Урок 10

Utility types

TypeScript предоставляет встроенные утилиты для преобразования типов.

Partial

Все поля опциональны:

type User = { name: string; age: number };
type PartialUser = Partial<User>;
// { name?: string; age?: number }

Используется для обновлений:

function update(id: number, patch: Partial<User>) {}
update(1, { name: 'Новое' });

Все поля обязательны:

type User = { name?: string; age?: number };
type RequiredUser = Required<User>;
// { name: string; age: number }

Все поля только для чтения:

type ReadonlyUser = Readonly<User>;

Выбрать определённые поля:

type UserPreview = Pick<User, 'id' | 'name'>;
// { id: number; name: string }

Исключить поля:

type SafeUser = Omit<User, 'password'>;

Словарь:

type Scores = Record<string, number>;
type Roles = Record<'admin' | 'user', string>;

Убрать из union:

type T = Exclude<'a' | 'b' | 'c', 'a'>;
// 'b' | 'c'

Оставить в union:

type T = Extract<'a' | 'b' | 'c', 'a' | 'b'>;
// 'a' | 'b'

Убрать null и undefined:

type T = NonNullable<string | null | undefined>;
// string

Тип возврата функции:

function getUser() {
    return { name: 'Алиса', age: 25 };
}

type User = ReturnType<typeof getUser>;
// { name: string; age: number }

Типы параметров функции:

function add(a: number, b: number) {}

type Params = Parameters<typeof add>;
// [number, number]

Тип после await:

type T = Awaited<Promise<string>>; // string

Тип экземпляра класса:

class User {}
type UserInstance = InstanceType<typeof User>;

type UpdateUser = Partial<Omit<User, 'id' | 'createdAt'>>;

Свои утилиты через mapped types:

type Nullable<T> = { [K in keyof T]: T[K] | null };
type Mutable<T> = { -readonly [K in keyof T]: T[K] };