Una firma de índice (index signature) describe el tipo de las propiedades cuando no conoces sus nombres de antemano, modelando diccionarios/mapas donde las claves son dinámicas.
{
[: ]: ;
}
: = { : , : };
scores. = ;
scores.;
scores.;
Con una firma de índice sencilla, el compilador asume que todas las claves existen, así que scores.typo se tipa como number aunque en realidad sea undefined en tiempo de ejecución. Activar noUncheckedIndexedAccess corrige esto:
// with noUncheckedIndexedAccess: true
scores.math; // number | undefined → forces you to handle the missing case
interface Config {
name: string; // known property
[key: string]: string | number; // plus arbitrary extra keys
}
Todas las propiedades con nombre deben ser asignables al tipo de valor de la firma de índice.
type Scores = Record<string, number>; // same as the index signature
type Roles = Record<"admin" | "user", boolean>; // constrained keys
Record es la forma abreviada idiomática y admite una unión de claves restringida, algo que un [key: string] simple no puede hacer.
Las firmas de índice modelan objetos con claves genuinamente dinámicas (tablas de búsqueda, cachés, mapas de JSON parseado).
Conoce la advertencia sobre seguridad (noUncheckedIndexedAccess) y prefiere Record<K, V> por legibilidad; y prefiere un Map cuando las claves son realmente abiertas y quieres semántica real de iteración/tamaño.