Antwort.

Der Mechanismus Partial<T> wurde in TypeScript eingeführt, um die Arbeit mit Objekten zu erleichtern, deren Eigenschaften vorübergehend nicht definiert sein können. Historisch gesehen mussten Entwickler manuell neue Typen erstellen, bei denen alle Eigenschaften optional gemacht wurden, was zu Code-Duplikationen und Fehlern führte.

Historie der Frage

Ursprünglich war es erforderlich, bei der Aktualisierung oder Erstellung von Objekten mit optionalen Feldern jede optionale Eigenschaft ausdrücklich anzugeben, was unangenehm war und keine Änderungen am ursprünglichen Interface unterstützte. So entstand der Utility-Typ Partial<T>, der automatisch alle Eigenschaften des Typs T in optional umwandelt.

Problem

Beim Entwerfen von APIs ist es häufig erforderlich, nur einen Teil des Objekts zu aktualisieren, ohne die anderen Felder zu berühren. Dies ist besonders wichtig für PATCH-Anfragen, Aktualisierungsformulare und Funktionen, die nur einen Teil der Daten verarbeiten. Ohne Partial wird die Typisierung kompliziert und anfällig.

Lösung

Es wird der Utility-Typ Partial<T> verwendet, der etwa so definiert ist:

// Vereinfacht:
type Partial<T> = { [P in keyof T]?: T[P] };

Damit werden alle Eigenschaften optional. Beispiel:

interface User {
  id: number;
  name: string;
  email: string;
}

function updateUser(id: number, user: Partial<User>) {
  // ...
}

// Man kann nur die zu ändernde Eigenschaft übergeben
updateUser(1, { email: "test@example.com" });

Wichtige Merkmale:

Ermöglicht es, nur die Felder zu beschreiben, die aktualisiert oder festgelegt werden sollen.
Erbt vollständig die Struktur des ursprünglichen Interfaces, was die Typensicherheit gewährleistet.
Lässt sich bequem mit anderen Utility-Typen kombinieren, z. B. Pick, Omit.

Fallstricke.

Kann man mit Partial alle Felder des ursprünglichen Interfaces verpflichtend machen?

Nein, Partial macht alle Eigenschaften optional. Für das umgekehrte Problem gibt es den Typ Required<T>.

Was passiert, wenn man Partial mit bereits optionalen Eigenschaften verwendet?

Partial ändert einfach die bereits optionalen Eigenschaften nicht; alle Felder bleiben optional, selbst wenn sie vor der Anwendung von Partial optional waren.

Beispiel:

interface X { x?: number; y: string; }
const a: Partial<X> = {}; // Beide Eigenschaften sind jetzt optional

Kann man Partial für verschachtelte Strukturen verwenden, wenn nur die inneren Felder optional gemacht werden sollen?

Partial wird nicht rekursiv auf verschachtelte Objekte angewendet. Wenn man alle inneren Eigenschaften optional machen möchte, muss man einen eigenen generischen Typ schreiben oder externe Utilities verwenden.

Typische Fehler und Antipatterns

Versuche, Partial für tiefe Strukturen ohne rekursive Hülle zu verwenden, was zu unerwarteten Typen führt.
Verwendung von Partial zur Erstellung von Objekten „von Grund auf“ – in der Folge entstehen Objekte ohne verpflichtende Felder.
Überschreibung des gesamten Objekts anstelle der Aktualisierung einzelner Eigenschaften, was den Vertragstyp verletzt.

Beispiel aus der Praxis

Negativer Fall

In einem CRUD-System akzeptiert updateUser Partial<User> und ermöglicht die Übergabe eines leeren Objekts, was zu Laufzeitfehlern führt: Verpflichtende Felder werden gelöscht.

Vorteile:

Flexibilität bei der Aktualisierung; keine Notwendigkeit, alles zu übergeben.

Nachteile:

Fehleranfälligkeit – ein Objekt ohne verpflichtende Felder wird in die Datenbank gespeichert.

Positiver Fall

Partial<User> wird nur zur Beschreibung des Eingabeformulars für die Aktualisierung verwendet. In der letzten Phase werden alle Felder validiert und mit dem ursprünglichen Objekt zusammengeführt, bevor sie in die Datenbank übergeben werden.