Bekannte und dynamische Schlüssel kombinieren
Kombinieren Sie feste Eigenschaften sicher mit Index-Signaturen.
Bekannte und dynamische Schlüssel kombinieren ist eine kostenlose TypeScript Academy-Lektion auf CoddyKit. Dies ist Lektion 3 von 4. Du kannst die komplette Lektion unten kostenlos lesen – dann übst du sie direkt im Browser mit einem integrierten Code-Editor und einem KI-Tutor rund um die Uhr. Sie ist Teil des TypeScript Academy-Lernpfads, und dein Fortschritt wird über Web und CoddyKit-App synchronisiert. Der TypeScript Academy-Kurs umfasst insgesamt 4 Lektionen.
Fest und flexibel zugleich
Oft besitzt ein Objekt einige garantierte Eigenschaften und zusätzlich eine offene Menge weiterer Eigenschaften. TypeScript ermöglicht es Ihnen, benannte Eigenschaften und eine Index-Signatur im selben Typ zu deklarieren – allerdings mit einer wichtigen Einschränkung.
Ein bekannter Schlüssel neben einer Signatur
Hier ist length immer vorhanden, während jeder andere String-Schlüssel auf einen Wert vom Typ number verweist. Die benannte Eigenschaft und die Index-Signatur bestehen nebeneinander.
interface NumberMap {
length: number
[key: string]: number
}
const m: NumberMap = { length: 2, a: 1, b: 1 }
console.log(m.length, m.a)Die Kompatibilitätsanforderung
Der entscheidende Punkt: Der Typ jeder festen Eigenschaft muss dem Werttyp der Index-Signatur zugewiesen werden können. Die Index-Signatur ist ein Versprechen für alle Schlüssel, daher muss jeder benannte Schlüssel dieses Versprechen einhalten.
interface Valid {
id: number // ok: number matches the signature
[key: string]: number
}
const v: Valid = { id: 1, score: 99 }
console.log(v.id + v.score)Wenn die Einschränkung verletzt wird
Wenn der Typ einer festen Eigenschaft nicht zum Werttyp des Index passt, weist TypeScript sie zurück. Eine als String benannte Eigenschaft kann nicht in einem Dictionary mit number-Werten enthalten sein.
// interface Broken {
// name: string // Error: string not assignable to number
// [key: string]: number
// }Den Werttyp des Index erweitern
Um verschiedene Typen fester Eigenschaften zuzulassen, erweitern Sie die Index-Signatur zu einer Union, die alle diese Typen abdeckt. Nun können sowohl ein String-Name als auch numerische Bewertungen verwendet werden.
interface Record {
name: string
[key: string]: string | number
}
const r: Record = { name: "ana", score: 10 }
console.log(r.name, r.score)Optionale feste Eigenschaften
Feste Eigenschaften können mit ? optional sein. Wenn sie vorhanden sind, müssen sie trotzdem mit der Index-Signatur kompatibel sein.
interface Config {
id: string
label?: string
[key: string]: string | undefined
}
const c: Config = { id: "x" }
console.log(c.label) // undefinedWarum optionale Eigenschaften undefined benötigen
Da eine optionale Eigenschaft fehlen kann, enthält ihr effektiver Typ undefined. Die Index-Signatur muss undefined daher ebenfalls zulassen, andernfalls meldet TypeScript einen Fehler für das optionale Element.
interface Safe {
title?: string
[key: string]: string | undefined
}
const s: Safe = {}
for (const k in s) console.log(s[k])Unterschiedliche Werttypen mit Unions
Ein realistisches Einstellungsobjekt: ein bekanntes boolesches Flag, ein bekannter String und beliebige zusätzliche Werte. Die Union der Signatur umfasst die Typen aller festen Eigenschaften.
interface Settings {
enabled: boolean
theme: string
[key: string]: boolean | string
}
const s: Settings = { enabled: true, theme: "dark", lang: "en" }
console.log(s.enabled, s.lang)Number-Index mit bekannten Schlüsseln
Die Einschränkung gilt auch für number-Index-Signaturen. Eine benannte numerische Eigenschaft muss zum Werttyp des number-Index passen.
interface Sparse {
count: number
[index: number]: number
}
const sp: Sparse = { count: 1, 0: 100, 1: 200 }
console.log(sp.count, sp[0])Eine übersichtlichere Alternative
Wenn die festen und die dynamischen Schlüssel wirklich voneinander unabhängige Typen haben, sollten Sie sie aufteilen: Verschachteln Sie den dynamischen Teil unter einer eigenen Eigenschaft. So vermeiden Sie eine unhandliche Union.
interface Better {
name: string
scores: { [key: string]: number }
}
const b: Better = { name: "ana", scores: { math: 90 } }
console.log(b.name, b.scores.math)Wann Sie sie kombinieren sollten
Kombinieren Sie bekannte und dynamische Schlüssel, wenn feste Eigenschaften natürlich denselben Werttyp wie die zusätzlichen Eigenschaften haben – etwa Zähler mit einem total oder gleichartige Einstellungen mit einigen garantierten Flags. Andernfalls sorgt eine Verschachtelung für stimmige Typen.
interface Tally {
total: number
[bucket: string]: number
}
const t: Tally = { total: 0, a: 3, b: 5 }
t.total = t.a + t.b
console.log(t.total) // 8Schnelltest
Testen Sie Ihr Verständnis der Kombination fester und dynamischer Schlüssel.
Zusammenfassung
Sie können feste Eigenschaften und eine Index-Signatur gemeinsam deklarieren, aber der Typ jeder festen Eigenschaft muss dem Werttyp der Index-Signatur zugewiesen werden können. Erweitern Sie die Signatur mit einer Union, um unterschiedliche Typen fester Eigenschaften aufzunehmen, und schließen Sie undefined ein, wenn feste Eigenschaften optional sind. Wenn die Typen tatsächlich voneinander unabhängig sind, verschachteln Sie den dynamischen Teil stattdessen unter einem eigenen Schlüssel.
Häufig gestellte Fragen
Ist die Lektion „Bekannte und dynamische Schlüssel kombinieren“ kostenlos?
Ja — der vollständige Text von „Bekannte und dynamische Schlüssel kombinieren“ ist hier im Web kostenlos zu lesen. Um sie interaktiv zu üben (integrierter Code-Editor und 24/7 KI-Tutor) und den Rest des TypeScript Academy-Kurses freizuschalten, upgrade auf CoddyKit PRO. Der TypeScript Academy-Kurs umfasst insgesamt 4 Lektionen.
Was lerne ich in „Bekannte und dynamische Schlüssel kombinieren“?
Kombinieren Sie feste Eigenschaften sicher mit Index-Signaturen. Du übst TypeScript Academy mit praktischem Code, den du direkt im Browser ausführst, und ein 24/7 KI-Tutor beantwortet deine Fragen während du die Lektion bearbeitest.
Brauche ich Erfahrung, um TypeScript Academy zu starten?
Keine Vorkenntnisse erforderlich. TypeScript Academy auf CoddyKit ist für Anfänger bis fortgeschrittene Lernende strukturiert, sodass du hier starten oder von Anfang an beginnen und in deinem eigenen Tempo voranschreiten kannst. Dies ist Lektion 3 von 4.
Wie lange dauert die Lektion „Bekannte und dynamische Schlüssel kombinieren“?
Die meisten CoddyKit-Lektionen dauern etwa 5–10 Minuten. Jede ist kompakt und interaktiv, sodass du stetig Fortschritte machst und genau dort weitermachst, wo du aufgehört hast – im Web und in der App.
Kann ich in dieser TypeScript Academy-Lektion Code schreiben und ausführen?
Ja. Jede TypeScript Academy-Lektion enthält einen integrierten Code-Editor, sodass du echten Code direkt in deinem Browser schreibst und ausführst und sofort KI-Feedback erhältst — ohne lokale Einrichtung erforderlich.
Alle Lektionen in diesem Kurs
- Index-Signaturen definieren
- String- und Number-Index-Signaturen
- Bekannte und dynamische Schlüssel kombinieren
- Index-Signaturen und Record