Antwort.

Hintergrund der Frage: In JavaScript verwenden Funktionen oft die Destrukturierung von Objekten direkt in der Signatur. In TypeScript erfordert dieser Ansatz eine klare Beschreibung der Struktur der destrukturierten Parameter und die Festlegung von Standardwerten – andernfalls können Fehler beim Zugriff auf nicht existierende Eigenschaften und falsche Typausgaben auftreten.

Problem: Es ist nicht offensichtlich, wie man den Typ des gesamten Parameters oder bestimmter verschachtelter Eigenschaften im destrukturierten Objekt korrekt beschreibt, insbesondere bei optionalen und verschachtelten Feldern sowie Standardwerten.

Lösung: Beschreiben Sie immer einen separaten Typ oder ein Interface für die Parameterstruktur der Funktion, und geben Sie deutlich an, welche Felder obligatorisch sind, welche optional sind, und legen Sie Standardwerte im Funktionskörper oder direkt in den Parametern mit Hilfe der ES6-Syntax fest.

Beispielcode:

interface UserOptions {
  name: string;
  age?: number;
  address?: { city: string; zipcode?: string };
}

function registerUser(
  { name, age = 18, address = { city: 'Unknown' } }: UserOptions
): string {
  return `${name}, ${age}, ${address.city}`;
}

Hauptmerkmale:

Verwenden Sie immer ein Interface oder einen Typ für die Destrukturierung verschachtelter Parameter.
Legen Sie Standardwerte für Felder in der Funktionssignatur fest.
Denken Sie immer an Szenarien, in denen optionale Eigenschaften (age?, address?) fehlen könnten.

Trickfragen.

Kann man die Typbeschreibung des Parameterobjekts weglassen und auf die automatische Typableitung vertrauen?

Nein, das ist gefährlich. Wenn man den Typ UserOptions nicht angibt, wird der Compiler nicht auf die obligatorischen Eigenschaften hinweisen, Standardwerte werden für verschachtelte Felder nicht erfasst, und es treten implizite Fehler bei der Nutzung auf.

function example({ x, y }) { ... } // x und y — any

Wie legt man einen Standardwert für ein verschachteltes Objekt fest, während man teilweise Eigenschaften ersetzt?

Verwenden Sie den Spread-Operator. Der Spread-Operator "verbindet" jedoch keine Typen, wenn der Typ address optional ist. Man muss eine Prüfung durchführen oder den Standardwert explizit angeben.

function fn({ obj = { foo: 1 } }: { obj?: { foo: number } }) {
  const address = { foo: 42, ...obj };
}

Warum ist die Destrukturierung mit optionalen Feldern ohne Standardwert gefährlich?

Wenn der Standardwert für optionale Eigenschaften weggelassen wird, kann der Zugriff auf Eigenschaften (z. B. address.city) zu Laufzeitfehlern führen. Es ist besser, ausdrücklich ? und einen Standardwert zu setzen.

function danger({ address }: { address?: { city: string } }) {
  console.log(address.city); // Fehler, address kann undefined sein
}

Typische Fehler und Anti-Pattern

Implizite Typisierung von destrukturierten Argumenten (any)
Fehlende Standardwerte für verschachtelte/optionale Eigenschaften
Keine Verwendung von Interfaces und Typalias für strukturelle Parameter

Beispiel aus dem Leben

Negativer Fall

Im alten Code wurde das Parameterobjekt ohne explizite Typisierung destrukturiert. Bei der Hinzufügung eines neuen Feldes zur Funktion wurden nicht alle Verwendungsstellen automatisch gefunden, was zu Fehlern in der Produktion führte.

Vorteile:

Schnell und einfach zu schreiben

Nachteile:

Fehlende Sicherheit und Kontrolle über die Struktur
Fragil bei Änderungen

Positiver Fall

Wir führten Interfaces für all solche Funktionen ein, testeten Szenarien mit undefined und Standardwerten, und die Hinweise des Compilers ermöglichten einfache, massenhafte Änderungen.