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

Что делает Record?

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

Record<K, V> создает объектный тип, где ключи имеют тип K, а значения - тип V.

Вопрос

Что делает Record?

Базовый пример

type Role = "admin" | "user" | "guest";
 
type Permissions = Record<Role, string[]>;
 
const permissions: Permissions = {
  admin: ["read", "write", "delete"],
  user: ["read", "write"],
  guest: ["read"],
};

TypeScript потребует указать все ключи из Role.

Словарь со строковыми ключами

type Scores = Record<string, number>;
 
const scores: Scores = {
  anna: 10,
  oleg: 7,
};

Record против index signature

Эти записи похожи:

type ScoresA = Record<string, number>;
 
type ScoresB = {
  [key: string]: number;
};

Record часто читается компактнее, особенно с union ключей.

Когда использовать

Record хорошо подходит для маппинга статусов, ролей, локализаций, обработчиков событий и таблиц соответствия.

type Status = "idle" | "loading" | "error";
 
const labels: Record<Status, string> = {
  idle: "Ожидание",
  loading: "Загрузка",
  error: "Ошибка",
};

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

  • Record<K, V> с union-ключом требует все ключи: удобно для словарей статусов и переводов.
  • Record<string, V> не гарантирует наличие ключа — с noUncheckedIndexedAccess чтение даст V | undefined.
  • satisfies Record<Status, string> проверяет полноту и сохраняет литеральные типы значений.
  • Для динамических словарей с частыми изменениями удобнее Map.

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

  • Record<K, V> = объект с ключами K и значениями V.
  • K обычно string, number, symbol или union литералов.
  • С union ключей требует заполнить все варианты.
  • Для динамических ключей похож на index signature.

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

TypeScript: Record.

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

Поиск

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