Type-fest für TypeScript: Vollständiger Leitfaden mit Beispielen

Was ist Type-fest und wozu wird es benötigt?

\n\n

Type-fest ist eine Sammlung von Hilfstypen für TypeScript, erstellt von der Community um Sindre Sorhus. Diese Bibliothek bietet Dutzende vorgefertigter Typen, die alltägliche Aufgaben bei der Entwicklung mit TypeScript lösen: von einfachen Transformationen (z. B. alle Felder eines Objekts optional machen) bis hin zu komplexen bedingten Typen (z. B. den Wertetyp aus einem Promise extrahieren).

\n\n

Wozu wird diese Bibliothek benötigt? TypeScript ist eine mächtige Sprache, aber seine eingebauten Typen (Partial, Required, Pick, Record) decken nur grundlegende Szenarien ab. In realen Projekten werden oft spezifischere Konstrukte benötigt: tiefe Objektvereinigung, Typen für die Arbeit mit JSON, strenge Typisierung von Konstanten, Extraktion von Typen aus komplexen Strukturen usw. Type-fest erspart die manuelle Erstellung dieser Typen, spart Zeit und reduziert die Wahrscheinlichkeit von Fehlern.

\n\n

Die Bibliothek wird aktiv gepflegt, hat über 10.000 Sterne auf GitHub und wird in großen Projekten wie Next.js, Vite und Expo verwendet.

\n\n

Installation

\n\n

Type-fest ist ein npm-Paket, das als dev-Abhängigkeit installiert wird (da Typen die Laufzeit nicht beeinflussen).

\n\n

# npm\nnpm install --save-dev type-fest\n\n# yarn\nyarn add --dev type-fest\n\n# pnpm\npnpm add --save-dev type-fest

\n\n

Hinweis: Die Bibliothek wird nicht über pip installiert – sie ist ausschließlich für TypeScript/JavaScript bestimmt.

\n\n

Schnellstart

\n\n

Nach der Installation können Sie jeden Typ aus der Bibliothek importieren. Betrachten wir ein einfaches Beispiel – die Verwendung des Typs PartialDeep, der alle Felder eines Objekts (einschließlich verschachtelter) optional macht.

\n\n

import type { PartialDeep } from 'type-fest';\n\ninterface User {\n  id: number;\n  name: string;\n  address: {\n    city: string;\n    zip: number;\n  };\n}\n\n// Normales Partial macht nur Felder der ersten Ebene optional\ntype PartialUser = Partial<User>;\n// { id?: number; name?: string; address?: { city: string; zip: number; } }\n\n// PartialDeep macht alle verschachtelten Felder optional\ntype DeepPartialUser = PartialDeep<User>;\n// { id?: number; name?: string; address?: { city?: string; zip?: number; } }\n\nconst user: DeepPartialUser = {\n  name: 'Alice',\n  address: {\n    city: 'Wonderland'\n    // zip kann weggelassen werden\n  }\n};

\n\n

Wie Sie sehen, durchläuft PartialDeep automatisch alle Verschachtelungsebenen – genau das, was man normalerweise manuell mit rekursiven Typen schreiben müsste.

\n\n

Wichtige Methoden/Typen

\n\n

Betrachten wir die 10 nützlichsten Typen aus Type-fest. Für jeden werden eine Beschreibung, Parameter (falls vorhanden) und ein funktionierendes Beispiel angegeben.

\n\n

1. PartialDeep

\n

Was es tut: Macht alle Eigenschaften eines Objekts (einschließlich verschachtelter) optional. Durchläuft rekursiv alle Ebenen.

\n

Parameter: Ein obligatorischer – der Objekttyp.

\n

import type { PartialDeep } from 'type-fest';\n\ninterface Config {\n  server: {\n    host: string;\n    port: number;\n  };\n  debug: boolean;\n}\n\ntype PartialConfig = PartialDeep<Config>;\n// {\n//   server?: {\n//     host?: string;\n//     port?: number;\n//   };\n//   debug?: boolean;\n// }\n\nconst config: PartialConfig = {\n  server: {\n    host: 'localhost'\n    // port nicht angegeben – kein Fehler\n  }\n};

\n\n

2. RequiredDeep

\n

Was es tut: Macht alle Eigenschaften eines Objekts (einschließlich verschachtelter) erforderlich. Das Gegenteil von PartialDeep.

\n

Parameter: Der Objekttyp.

\n

import type { RequiredDeep } from 'type-fest';\n\ninterface User {\n  name?: string;\n  address?: {\n    city?: string;\n  };\n}\n\ntype StrictUser = RequiredDeep<User>;\n// {\n//   name: string;\n//   address