Deklarationen und Merging

Die Typdeklarationsdateien (mit der Endung .d.ts) werden in TypeScript verwendet, um die Struktur von vorhandenem JavaScript-Code zu beschreiben, ohne tatsächliche Logik zu implementieren. Sie enthalten nur Definitionen von Typen, Schnittstellen und Funktionssignaturen.

Diese Dateien sind unerlässlich, wenn wir Bibliotheken von Drittanbietern verwenden, die in reinem JavaScript geschrieben sind.

Declaration Merging (Zusammenführen von Deklarationen)

Declaration Merging ist ein Verhalten, bei dem der Compiler zwei oder mehr separate Definitionen mit demselben Namen zu einer einzigen Definition zusammenführt.

Der häufigste Fall ist das Zusammenführen von Schnittstellen (Interfaces):

interface User {
  name: string;
}

interface User {
  age: number;
}

// Das resultierende Interface User besitzt sowohl name als auch age!
const student: User = {
  name: 'Alice',
  age: 23,
};

Wenn Eigenschaften denselben Namen haben, müssen sie vom selben Typ sein, andernfalls meldet TypeScript einen Fehler.

Globale und externe Module ändern

Wir können Declaration Merging verwenden, um Schnittstellen zu erweitern, die in anderen Modulen oder im globalen Gültigkeitsbereich definiert sind.

Wenn wir beispielsweise dem globalen window-Objekt des Browsers eine Eigenschaft hinzufügen möchten:

declare global {
  interface Window {
    analyticsToken: string;
  }
}

Mit declare global teilen wir TypeScript mit, dass wir eine neue Signatur in das bereits global vorhandene Window-Interface einfügen.

Probier es aus

Aufgabe 1: Einfaches Declaration Merging

Aufgabe 2: Erweiterung des globalen Window-Interfaces