Что такое индексные сигнатуры?

Question

Accepted Answer

**Индексная сигнатура** описывает тип свойств, когда вы заранее не знаете их имена — моделирует словари/карты, где ключи динамические. ```ts interface StringMap { [key: string]: number; // any string key maps to a number } const scores: StringMap = { math: 90, science: 85 }; scores.history = 70; // ✅ any string key allowed scores.math; // number scores.unknownKey; // number (TS assumes it exists!) — a caveat ``` ## Предостережение о безопасности С простой индексной сигнатурой компилятор предполагает, что **каждый** ключ существует, поэтому `scores.typo` типизирован как `number`, даже если на самом деле это `undefined` во время выполнения. Включение `noUncheckedIndexedAccess` это исправляет: ```ts // with noUncheckedIndexedAccess: true scores.math; // number | undefined → forces you to handle the missing case ``` ## Сочетание фиксированных и динамических ключей ```ts interface Config { name: string; // known property [key: string]: string | number; // plus arbitrary extra keys } ``` Все именованные свойства должны быть присваиваемы типу значения индексной сигнатуры. ## Record часто чище ```ts type Scores = Record; // same as the index signature type Roles = Record<"admin" | "user", boolean>; // constrained keys ``` `Record` — это идиоматическое сокращение и поддерживает ограниченное объединение ключей, чего не может простой `[key: string]`. ## Почему это важно Индексные сигнатуры моделируют объекты с подлинно динамическими ключами (таблицы поиска, кэши, разобранные карты JSON). Знайте предостережение о безопасности (`noUncheckedIndexedAccess`) и отдавайте предпочтение `Record` для читаемости — и отдавайте предпочтение `Map`, когда ключи действительно открыты и вам нужна реальная семантика итерации/размера.