Record: mapeando chaves para tipos de valores

Boas-vindas

Sintaxe básica de Record

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

Record com chaves de string

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

Record para tabelas de consulta

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

Como Record é implementado

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

Record versus assinatura de índice

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

Record com valores de união

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

Record parcial

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

Record somente leitura

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

Record para agrupamento

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 com chaves de enumeração

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

Verificação rápida

Recapitulação