Реализация `Record` проста: ```typescript // Встроенная реализация type Record = { [P in K]: V; }; ``` `K` может быть `string`, `number`, `symbol` или union литеральных типов. ```typescript // Словарь с произвольными строковыми ключами type StringMap = Record; const wordCounts: StringMap = { hello: 5, world: 3, }; // Фиксированный набор ключей type Role = "admin" | "editor" | "viewer"; type RolePermissions = Record; const permissions: RolePermissions = { admin: ["read", "write", "delete"], editor: ["read", "write"], viewer: ["read"], }; // Пропустить ключ нельзя — TypeScript потребует все три ``` ## Record vs index signature ```typescript // Index signature interface DictA { [key: string]: number; } // Record — то же самое, но короче type DictB = Record; // Разница видна с union-ключами type Status = "loading" | "success" | "error"; // Record гарантирует ВСЕ ключи type StatusMap = Record; const messages: StatusMap = { loading: "Загрузка...", success: "Готово!", error: "Ошибка!", // Забыл один ключ — ошибка компиляции }; // Index signature такого не умеет interface StatusMapLoose { [key: string]: string; // Любой ключ — нет контроля } ``` ## 📌 Реальные кейсы **Маппинг статусов HTTP:** ```typescript type HttpStatus = 200 | 201 | 400 | 401 | 403 | 404 | 500; const statusMessages: Record = { 200: "OK", 201: "Created", 400: "Bad Request", 401: "Unauthorized", 403: "Forbidden", 404: "Not Found", 500: "Internal Server Error", }; ``` **Группировка данных:** ```typescript interface Student { name: string; grade: "A" | "B" | "C" | "D" | "F"; } function groupByGrade(students: Student[]): Record { const groups: Record = { A: [], B: [], C: [], D: [], F: [], }; for (const student of students) { groups[student.grade].push(student); } return groups; } ``` **Кеш с типизированными ключами:** ```typescript type CacheKey = "users" | "products" | "orders"; interface CacheEntry { data: T; expiresAt: number; } type AppCache = Record | null>; const cache: AppCache = { users: { data: [{ id: 1 }], expiresAt: Date.now() + 60000 }, products: null, orders: null, }; ``` **Конфиг feature flags:** ```typescript type Feature = "darkMode" | "notifications" | "beta" | "analytics"; const featureFlags: Record = { darkMode: true, notifications: true, beta: false, analytics: true, }; function isEnabled(feature: Feature): boolean { return featureFlags[feature]; } ``` ## Частые ошибки ❌ Использовать `Record` когда набор ключей известен: ```typescript // Слишком свободно — можно обратиться к любому ключу const config: Record = { host: "localhost" }; console.log(config.oops); // undefined в runtime, но TypeScript не ругается ``` ✅ Используй union для фиксированных ключей: ```typescript type ConfigKey = "host" | "port" | "dbUrl"; const config: Record = { host: "localhost", port: "3000", dbUrl: "postgres://...", }; // config.oops — ошибка компиляции ``` ❌ Путать `Record` с `Map`: ```typescript // Record — это обычный объект, ключи приводятся к строкам const nums: Record = {}; nums[1] = "один"; // Object.keys(nums) вернёт ["1"] — строку! ``` ## Резюме `Record` создаёт типизированный словарь. С union-ключами гарантирует полноту (все ключи обязательны). С `string`/`number` работает как index signature, но в более компактной записи. Идеален для маппингов, lookup-таблиц, конфигов и группировок. ---

Что такое Record<K, V>?