Record: сопоставление ключей с типами значений

Добро пожаловать

Базовый синтаксис Record

type Roles = Record<'admin' | 'user' | 'guest', boolean>;
const access: Roles = { admin: true, user: true, guest: false };

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

const headers: Record<string, string> = {
  'content-type': 'application/json',
  'authorization': 'Bearer token'
};

Record для таблиц поиска

const statusLabels: Record<number, string> = {
  200: 'OK',
  404: 'Not Found',
  500: 'Server Error'
};

Как реализован Record

type Record<K extends string | number | symbol, V> = { [P in K]: V };

Record и сигнатура индекса

// Equivalent:
type A = Record<string, number>;
type B = { [key: string]: number };

Record с объединением значений

type Config = Record<'development' | 'staging' | 'production', { url: string; debug: boolean }>;

Частичный Record

type OptionalConfig = Partial<Record<'debug' | 'verbose' | 'trace', boolean>>;

Только для чтения Record

const CODES: Readonly<Record<string, number>> = { A: 1, B: 2 };

Record для группировки

function groupBy<T>(items: T[], key: keyof T): Record<string, T[]> {
  return items.reduce((acc, item) => {
    const k = String(item[key]);
    (acc[k] ??= []).push(item);
    return acc;
  }, {} as Record<string, T[]>);
}

Record с ключами перечисления

enum Color { Red = 'RED', Green = 'GREEN', Blue = 'BLUE' }
const hexCodes: Record<Color, string> = {
  [Color.Red]: '#FF0000',
  [Color.Green]: '#00FF00',
  [Color.Blue]: '#0000FF',
};

Быстрая проверка

Итоги