Czym są sygnatury indeksów?

Question

Accepted Answer

**Sygnatura indeksu** opisuje typ właściwości, gdy wcześniej nie znasz ich nazw — modelując słowniki/mapy, w których klucze są dynamiczne. ```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 ``` ## Dlaczego to ważne Z zwykłą sygnaturą indeksu kompilator zakłada, że **każdy** klucz istnieje, więc `scores.typo` jest wpisany jako `number`, nawet jeśli w rzeczywistości jest `undefined` w czasie wykonania. Włączenie `noUncheckedIndexedAccess` to naprawia: ```ts // with noUncheckedIndexedAccess: true scores.math; // number | undefined → forces you to handle the missing case ``` ## Łączenie stałych i dynamicznych kluczy ```ts interface Config { name: string; // known property [key: string]: string | number; // plus arbitrary extra keys } ``` Wszystkie nazwane właściwości muszą być przypisywalne do typu wartości sygnatury indeksu. ## Record jest często czystszy ```ts type Scores = Record; // same as the index signature type Roles = Record<"admin" | "user", boolean>; // constrained keys ``` `Record` to idiomatyczna skrótowa forma i obsługuje ograniczoną unię kluczy, czego zwykły `[key: string]` nie może. ## Dlaczego to ważne Sygnatury indeksów modelują obiekty z naprawdę dynamicznym kluczem (tabele wyszukiwania, cache'e, przeanalizowane mapy JSON). Znaj zastrzeżenie dotyczące bezpieczeństwa (`noUncheckedIndexedAccess`) i preferuj `Record` dla czytelności — i preferuj `Map`, gdy klucze są naprawdę otwarte i chcesz prawdziwej semantyki iteracji/rozmiaru.