O que são assinaturas de índice?

Question

Accepted Answer

Uma **assinatura de índice** descreve o tipo de propriedades quando você não conhece seus nomes antecipadamente — modelando dicionários/mapas onde as chaves são dinâmicas. ```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 ``` ## O aviso de segurança Com uma assinatura de índice simples, o compilador assume que **toda** chave existe, então `scores.typo` é digitado como `number` mesmo que seja realmente `undefined` em tempo de execução. Habilitar `noUncheckedIndexedAccess` corrige isso: ```ts // with noUncheckedIndexedAccess: true scores.math; // number | undefined → forces you to handle the missing case ``` ## Combinando chaves fixas e dinâmicas ```ts interface Config { name: string; // known property [key: string]: string | number; // plus arbitrary extra keys } ``` Todas as propriedades nomeadas devem ser atribuíveis ao tipo de valor da assinatura de índice. ## Record é geralmente mais limpo ```ts type Scores = Record; // same as the index signature type Roles = Record<"admin" | "user", boolean>; // constrained keys ``` `Record` é a abreviatura idiomática e suporta uma união de chaves restrita, o que um simples `[key: string]` não consegue. ## Por que isso importa Assinaturas de índice modelam objetos genuinamente dinâmicos com chave (tabelas de consulta, caches, mapas JSON analisados). Conheça o aviso de segurança (`noUncheckedIndexedAccess`) e prefira `Record` para legibilidade — e prefira um `Map` quando as chaves são realmente abertas e você deseja semântica real de iteração/tamanho.