Schemas kombinieren und verfeinern
Erstellen Sie komplexe Schemas mit refine, transform und Unions.
Schemas kombinieren und verfeinern ist eine kostenlose TypeScript Academy-Lektion auf CoddyKit. Dies ist Lektion 4 von 4. Du kannst die komplette Lektion unten kostenlos lesen – dann übst du sie direkt im Browser mit einem integrierten Code-Editor und einem KI-Tutor rund um die Uhr. Sie ist Teil des TypeScript Academy-Lernpfads, und dein Fortschritt wird über Web und CoddyKit-App synchronisiert. Der TypeScript Academy-Kurs umfasst insgesamt 4 Lektionen.
Schemas kombinieren
Zod-Schemas sind kombinierbare Bausteine. Sie können sie verfeinern, transformieren, erweitern und kombinieren, um komplexe Validierungsregeln abzubilden.
import { z } from "zod";
const base = z.object({ name: z.string() });
// We will add rules and combine schemas from here.Benutzerdefinierte Regeln mit refine
.refine fügt ein benutzerdefiniertes Validierungsprädikat mit einer Fehlermeldung hinzu – für Regeln, für die Zod keine integrierte Unterstützung bietet.
import { z } from "zod";
const password = z.string().refine(
(s) => s.length >= 8,
{ message: "Must be at least 8 characters" }
);
// password.parse("short") throws with that message.Über mehrere Felder hinweg verfeinern
Wenden Sie .refine auf ein Objekt an, um Beziehungen zwischen Feldern zu validieren, etwa ob die Passwortbestätigung mit dem Passwort übereinstimmt.
import { z } from "zod";
const form = z.object({
password: z.string(),
confirm: z.string()
}).refine((d) => d.password === d.confirm, {
message: "Passwords must match"
});
// Validates both fields together.Werte transformieren
.transform wandelt einen validierten Wert in eine andere Struktur um, nachdem die Validierung erfolgreich war.
import { z } from "zod";
const trimmed = z.string().transform((s) => s.trim());
const result = trimmed.parse(" hi "); // "hi"Optionale Felder
.optional() erlaubt, dass ein Feld fehlt. Das wird sowohl in der Validierung als auch im inferierten Typ abgebildet.
import { z } from "zod";
const schema = z.object({
name: z.string(),
bio: z.string().optional()
});
// bio may be omitted.Standardwerte
.default liefert einen Wert, wenn die Eingabe fehlt, sodass das geparste Ergebnis das Feld immer enthält.
import { z } from "zod";
const schema = z.object({
retries: z.number().default(3)
});
const r = schema.parse({}); // { retries: 3 }Union-Schemas
z.union akzeptiert einen Wert, der einem beliebigen von mehreren Schemas entspricht – das Zod-Gegenstück zu einer TypeScript-Union.
import { z } from "zod";
const id = z.union([z.string(), z.number()]);
// id.parse("abc") and id.parse(123) both succeed.Diskriminierte Unions in Zod
z.discriminatedUnion validiert getaggte Unions effizient, indem anhand eines Diskriminatorfelds zwischen ihnen gewählt wird.
import { z } from "zod";
const shape = z.discriminatedUnion("kind", [
z.object({ kind: z.literal("circle"), radius: z.number() }),
z.object({ kind: z.literal("square"), side: z.number() })
]);
// Picks the right member by kind.Mit extend zusammenführen
.extend fügt einem vorhandenen Objekt-Schema Felder hinzu, sodass Sie aus kleineren Schemas größere erstellen können.
import { z } from "zod";
const base = z.object({ id: z.number() });
const user = base.extend({ name: z.string() });
// user validates { id: number; name: string }Objekt-Schemas kombinieren
Sie können auch zwei Objekt-Schemas mit .merge zusammenführen und dadurch alle ihre Felder in einem Schema kombinieren.
import { z } from "zod";
const a = z.object({ x: z.number() });
const b = z.object({ y: z.string() });
const combined = a.merge(b);
// combined validates { x: number; y: string }Alles miteinander verketten
Verfeinerungen, Transformationen, Standardwerte und Erweiterungen lassen sich flüssig verketten, um umfangreiche Validierungen in einem einzigen gut lesbaren Schema auszudrücken.
import { z } from "zod";
const signup = z.object({
email: z.string().refine(s => s.includes("@"), { message: "Invalid email" }),
age: z.number().default(18)
}).extend({
newsletter: z.boolean().optional()
});
// One schema, many rules.Kurzer Check: Schemas kombinieren
Testen Sie Ihr Verständnis des Kombinierens und Verfeinerns von Schemas.
Zusammenfassung: Schemas kombinieren und verfeinern
Sie haben gelernt, mit .refine benutzerdefinierte Regeln hinzuzufügen, mit .transform Werte umzuformen, mit .optional und .default fehlende Daten zu behandeln, mit z.union Alternativen zu kombinieren und Schemas mit .extend und .merge zu erweitern.
import { z } from "zod";
const schema = z.object({ name: z.string() })
.extend({ age: z.number().default(0) })
.refine(d => d.name.length > 0, { message: "Name required" });
// Composed validation in one place.Lerne TypeScript mit einem KI-Tutor — kostenlos
Schreibe und führe echten Code in deinem Browser aus, bekomme sofortige Hilfe von einem 24/7 KI-Tutor und setze dein Lernen im Web oder in der App fort.
- Kurse
- 101
- Lektionen
- 352
Häufig gestellte Fragen
Ist die Lektion „Schemas kombinieren und verfeinern“ kostenlos?
Ja — der vollständige Text von „Schemas kombinieren und verfeinern“ ist hier im Web kostenlos zu lesen. Um sie interaktiv zu üben (integrierter Code-Editor und 24/7 KI-Tutor) und den Rest des TypeScript Academy-Kurses freizuschalten, upgrade auf CoddyKit PRO. Der TypeScript Academy-Kurs umfasst insgesamt 4 Lektionen.
Was lerne ich in „Schemas kombinieren und verfeinern“?
Erstellen Sie komplexe Schemas mit refine, transform und Unions. Du übst TypeScript Academy mit praktischem Code, den du direkt im Browser ausführst, und ein 24/7 KI-Tutor beantwortet deine Fragen während du die Lektion bearbeitest.
Brauche ich Erfahrung, um TypeScript Academy zu starten?
Keine Vorkenntnisse erforderlich. TypeScript Academy auf CoddyKit ist für Anfänger bis fortgeschrittene Lernende strukturiert, sodass du hier starten oder von Anfang an beginnen und in deinem eigenen Tempo voranschreiten kannst. Dies ist Lektion 4 von 4.
Wie lange dauert die Lektion „Schemas kombinieren und verfeinern“?
Die meisten CoddyKit-Lektionen dauern etwa 5–10 Minuten. Jede ist kompakt und interaktiv, sodass du stetig Fortschritte machst und genau dort weitermachst, wo du aufgehört hast – im Web und in der App.
Kann ich in dieser TypeScript Academy-Lektion Code schreiben und ausführen?
Ja. Jede TypeScript Academy-Lektion enthält einen integrierten Code-Editor, sodass du echten Code direkt in deinem Browser schreibst und ausführst und sofort KI-Feedback erhältst — ohne lokale Einrichtung erforderlich.
Alle Lektionen in diesem Kurs
- Grundlagen von Zod-Schemas
- Typen aus Schemas ableiten
- parse und safeParse
- Schemas kombinieren und verfeinern