HOWTO · TypeScript

Erweitern Sie den Typ in TypeScript

Erfahren Sie, wie TypeScript-Schnittstellen andere Schnittstellen erweitern und wie Typaliase Objektformen zusammensetzen.

Auf dieser Seite

Verwenden Sie in TypeScript extends, wenn eine Schnittstelle die Mitglieder einer anderen Schnittstelle erben soll. Ein type alias kann diese Deklarationsform nicht verwenden, aber Objektformen lassen sich mit einem intersection type über & zusammensetzen. Die Ansätze überschneiden sich bei vielen Objektformen, sind aber nicht identisch: Schnittstellen unterstützen Declaration Merging, während Intersection-Typen Typen kombinieren und bei gleichnamigen Mitgliedern mit widersprüchlichen Typen eine unbrauchbare Eigenschaft erzeugen können.

Eine Schnittstelle in TypeScript erweitern

Eine erweiternde Schnittstelle behält die Mitglieder der Basis und fügt eigene Anforderungen hinzu. Beispielsweise lässt sich interface Project { submit(data: string): boolean; queue(data: string): boolean; } mit interface ProjectManagement extends Project { submitRequirements(data: string, id: number): boolean; } erweitern. Ein Wert vom Typ ProjectManagement muss alle drei Methoden bereitstellen. Das Schlüsselwort extends beschreibt eine Beziehung zwischen Schnittstellen; es liefert keine Methodenimplementierungen.

Das folgende JavaScript-Beispiel macht die resultierende Objektform sichtbar:

const projectManagement = {
  submit(data) {
    return data.length > 0;
  },
  queue(data) {
    return data.length > 0;
  },
  submitRequirements(data, id) {
    return data.length > 0 && id > 0;
  },
};

console.log(projectManagement.submitRequirements("Roadmap", 7));
true

Dieses JavaScript-Objekt demonstriert die drei Methodenimplementierungen, aber JavaScript selbst prüft die TypeScript-Schnittstelle nicht. Wenn Sie nur Objektformen kombinieren müssen, kann ein Typalias ein ähnliches Ergebnis ausdrücken: type ProjectManagement = Project & { submitRequirements(data: string, id: number): boolean; }. Bevorzugen Sie die Schnittstellenerweiterung für einen Schnittstellenvertrag, der möglicherweise erweitert oder zusammengeführt wird; verwenden Sie eine Intersection, wenn Sie Aliase oder andere Typen zusammensetzen.

Mehrere Schnittstellen in TypeScript erweitern

Eine Schnittstelle kann mehrere Schnittstellen erweitern, indem ihre Namen durch Kommas getrennt nach extends aufgelistet werden. Beispielsweise definieren interface HasId { id: number; }, interface HasLabel { label: string; } und interface SelectableItem extends HasId, HasLabel { selected: boolean; } einen kombinierten Vertrag mit drei unterschiedlichen Eigenschaften. Ein SelectableItem-Wert muss id, label und selected bereitstellen.

Das ist nützlich, wenn unabhängig definierte Fähigkeiten einen gemeinsamen Objektvertrag bilden müssen. Wenn zwei Basisschnittstellen dieselbe Eigenschaft mit inkompatiblen Typen deklarieren, kann TypeScript daraus keine gültige erweiternde Schnittstelle bilden. Gleichen Sie die Deklarationen an oder wählen Sie ein anderes Modell. Bei Typaliasen kombinieren Intersections ebenfalls Mitglieder, aber widersprüchliche Eigenschaftstypen können die resultierende Eigenschaft unerfüllbar machen, statt den Konflikt automatisch aufzulösen.

Eine Klasse mit einer Schnittstelle in TypeScript erweitern

Eine Schnittstelle kann eine Klasse erweitern und deren Instanzmitglieder erben. Wenn die Klasse nur öffentliche Mitglieder bereitstellt, kann eine nicht verwandte Klasse die resultierende Schnittstelle implementieren, indem sie dieselbe öffentliche Form bereitstellt. Private oder geschützte Mitglieder fügen eine Herkunftsbeschränkung hinzu: Eine implementierende Klasse muss diese Mitglieder von der Klasse erben, die in der extends-Klausel der Schnittstelle genannt ist.

Beispielsweise macht class Key { private value = true; } gefolgt von interface Lock extends Key { enable(): void; } das private Mitglied von Key zu einem Teil des erforderlichen Instanztyps, obwohl Code, der Lock verwendet, nicht auf value zugreifen kann. class FingerPrint extends Key implements Lock { enable(): void {} } ist gültig, weil FingerPrint genau dieses private Mitglied von Key erbt. Ein nicht verwandtes class Unrelated implements Lock { enable(): void {} } wird abgelehnt: Ein eigenes privates Mitglied mit demselben Namen zu deklarieren macht es nicht zu dem von Key geerbten Mitglied.

Verwenden Sie dieses Muster, wenn die Klassenbeziehung beabsichtigt ist. Für einen Vertrag mit nur öffentlichen Mitgliedern ist es in der Regel einfacher, eine Schnittstelle direkt zu implementieren. Die Schnittstellenerweiterung prüft die Instanzform der Klasse zur Kompilierzeit; sie kopiert weder die Implementierung der Klasse in die Schnittstelle noch in eine implementierende Klasse.