Antwort.

Hintergrund der Frage

Declaration Merging ist ein einzigartiges Merkmal von TypeScript, das es ermöglicht, mehrere Deklarationen mit dem gleichen Namen in eine einzige Entität zu kombinieren. Dies hängt mit der Geschichte von TypeScript als Typisierung über JavaScript zusammen: Viele Drittanbieter-Bibliotheken haben Schnittstellen, Funktionen und Namensräume deklariert, und TypeScript musste es ermöglichen, diese zu erweitern, ohne den ursprünglichen Code der Bibliothek zu modifizieren.

Problem

In komplexen APIs und bei der Typisierung von Drittanbieter-JS-Bibliotheken kann es notwendig sein, die Verantwortlichkeiten aufzuteilen — zum Beispiel, Typen eines Moduls zu erweitern, Felder zu Schnittstellen hinzuzufügen oder Namen zu kombinieren. Die meisten Programmiersprachen unterstützen jedoch eine solche Kombination von Deklarationen nicht.

Lösung

TypeScript ermöglicht es, Deklarationen von Schnittstellen, Namensräumen, Funktionen und Klassen mit gleichen Namen zu mergen, was die API flexibel für Erweiterungen macht. Sie wird verwendet, um Drittanbieter-Typen zu erweitern, benutzerdefinierte Methoden zu Bibliotheken hinzuzufügen und modulare Codestrukturen zu organisieren.

Beispielcode:

// Schnittstellens merging
interface User {
  id: number;
}
interface User {
  name: string;
}
const u: User = { id: 1, name: "Jack" };

// Namensraum + Funktionen merging
function greet() {
  return "Hi!";
}
namespace greet {
  export function loud() { return "HI!"; }
}
greet(); // "Hi!"
greet.loud(); // "HI!"

Schlüsselfunktionen:

Ermöglicht das Mergen von Schnittstellen, Funktionen mit Namensräumen, Enums mit Namensräumen, aber nicht Typen.
Wird verwendet, um erweiterbare APIs und globale Erweiterungen von Deklarationen zu beschreiben.
Ermöglicht das sichere Modifizieren/Erweitern von Typen von Drittanbieter-Bibliotheken ohne deren Veränderung.

Trickfragen.

Kann man type aliases ähnlich wie Schnittstellen mergen?

Nein, type aliases können nicht gemergt werden. Bei dem Versuch, mehrere types mit dem gleichen Namen zu deklarieren, wird ein Kompilierungsfehler auftreten.

type T = { a: string };
type T = { b: number }; // Fehler

Setzt TypeScript die Felder von Schnittstellen/Namensräumen in zufälliger Reihenfolge ein?

Die gemergte Struktur wird immer in der Reihenfolge der Deklaration aufgebaut — wenn es gleiche Eigenschaftsnamen gibt, "gewinnt" die letzte Deklaration.

Werden Methoden einer Schnittstelle in eine Funktion gemergt?

Nein, Methoden mit denselben Namen in verschiedenen Schnittstellen werden nicht in eine Funktion gemergt — selbst wenn die Signaturen übereinstimmen, erlaubt TypeScript nicht die Implementierung von "beiden" Varianten.

Typische Fehler und Anti-Patterns

Versuche, type aliases oder enums ohne Namensräume zu mergen — verursacht einen Fehler.
Wiederholte Felder mit unterschiedlichen Typen innerhalb von Schnittstellen — Konflikt, werden nicht gemergt;
Merging ohne bewusste Notwendigkeit verwenden — führt zu unlesbarem Code.

Beispiel aus der Praxis

Negativer Fall

Ein Unternehmen definiert die globale Schnittstelle Window zweimal mit unterschiedlichen Feldern und unterschiedlichen Typen für das gleiche Namensfeld. Während des Builds bemerkt der Compiler das Problem nicht, und beim Ausführen tritt ein unerwarteter Typkonflikt auf.

Vorteile:

Schnelle Möglichkeit, eine Schnittstelle zu "erweitern", ohne den Quellcode zu ändern.

Nachteile:

Konfliktielle Namen führen zu Bugs, die schwer zu finden sind.
Erschwert oft das Verständnis der vollständigen Struktur des Typs.

Positiver Fall

Eine d.ts-Datei wird für eine Drittanbieter-Bibliothek geschrieben, bei der die API-Schnittstelle durch separate Module erweitert wird, ohne die Bibliothek selbst zu ändern; alle Erweiterungen sind dokumentiert, die Namensrichtlinien sind in der Wiki beschrieben.