.ts · text/typescript

Zod-Schema: Zod-Validierungsschema zur Laufzeit

Zod-Schemas verbinden JSON-Validierung zur Laufzeit (`z.object`, `z.array`, `.optional()`) mit automatischer statischer Typisierung per `z.infer<typeof schema>`.

Schnellantwort: Zod-Schemas verbinden JSON-Validierung zur Laufzeit (`z.object`, `z.array`, `.optional()`) mit automatischer statischer Typisierung per `z.infer<typeof schema>`. Validierung an API-Grenzen zur Laufzeit, tRPC-/React-Hook-Form-Schemas und Single-Source-Typableitung.

StrukturtypTypisierter Code
MenschenlesbarkeitHoch
VerschachtelungJa
LLM-Token-EffizienzMittel
Dateiendung.ts
MIME-Typtext/typescript
Ideal fürValidierung an API-Grenzen zur Laufzeit, tRPC-/React-Hook-Form-Schemas und Single-Source-Typableitung.

Stärken

  • Validiert ungeprüftes JSON zur Laufzeit und leitet statische TS-Typen direkt ab
  • Erkennt fehlende Felder, falsche Primitives und API-Drift früh mit klaren Fehlern
  • Unterstützt strikte Objektprüfungen (.strict()) zum Ablehnen unbekannter Felder

Kompromisse

  • Fügt der Laufzeit kleine Bibliotheksgröße gegenüber reinem TypeScript hinzu
  • Tief rekursive Schemas benötigen explizite manuelle Typhilfen
  • Strikter Modus kann bei neuen API-Feldern die Abwärtskompatibilität brechen

Referenzen

Zod-Schema lokal konvertieren & bereinigen

Verwandte Technik-Guides

Verwandte Formate

Alle 24 Formate

Häufige Fragen zu Zod-Schema

Warum Zod-Schemas statt einfacher TypeScript-Interfaces generieren?

TypeScript-Typen verschwinden zur Laufzeit. Zod prüft echte eingehende JSON-Daten im Betrieb und exportiert zugleich z.infer<typeof schema>.

Was bewirkt Striktes Objekt in JSON to Zod?

Es hängt .strict() an erzeugte z.object(...)-Schemas an, sodass unbekannte Zusatzeigenschaften einen Validierungsfehler werfen statt ignoriert zu werden.

Werden verschachtelte JSON-Objekte und gemischte Arrays automatisch behandelt?

Ja. Verschachtelte Strukturen erzeugen sauber gestaffelte z.object(), z.array(), z.union() sowie .nullable()- und .optional()-Modifikatoren.