Урок 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.
Документация
Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.