TypeScript Academy · Lektion

Grundlagen von Zod-Schemas

Definieren Sie Schemas für primitive Typen, Objekte und Arrays.

Grundlagen von Zod-Schemas ist eine kostenlose TypeScript Academy-Lektion auf CoddyKit. Dies ist Lektion 1 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.

Warum Laufzeitvalidierung?

TypeScript-Typen verschwinden zur Laufzeit. Daten aus APIs, Formularen und Dateien sind an der Grenze untypisiert. Zod validiert diese Daten zur Laufzeit und liefert Ihnen zusätzlich die passenden Typen.

import { z } from "zod";
// Types check at compile time; Zod checks values at runtime.

Zod importieren

Importieren Sie den z-Namespace aus dem Paket zod. Jeder Schema-Builder befindet sich auf z.

import { z } from "zod";
const nameSchema = z.string();
// nameSchema validates that a value is a string.

Primitive Schemas

Zod bietet Builder für primitive Typen: z.string(), z.number() und z.boolean() validieren jeweils eine bestimmte Art von Wert.

import { z } from "zod";
const name = z.string();
const age = z.number();
const active = z.boolean();
// Use .parse(value) to validate at runtime.

Einen Wert validieren

Rufen Sie .parse auf einem Schema auf, um zu validieren. Bei einem gültigen Wert wird dieser zurückgegeben, andernfalls wird ein Fehler ausgelöst.

import { z } from "zod";
const schema = z.string();
const result = schema.parse("hello"); // "hello"
const broken = schema.parse(123); // throws ZodError

Objekt-Schemas

z.object beschreibt die Struktur eines Objekts, indem jedem Schlüssel ein Schema für seinen Wert zugeordnet wird.

import { z } from "zod";
const userSchema = z.object({
  name: z.string(),
  age: z.number()
});
// userSchema.parse({ name: "Ada", age: 36 }) succeeds.

Array-Schemas

z.array validiert, dass ein Wert ein Array ist, dessen Elemente alle einem vorgegebenen Schema entsprechen.

import { z } from "zod";
const tags = z.array(z.string());
// tags.parse(["a", "b"]) succeeds; tags.parse([1]) throws.

Schemas verschachteln

Schemas lassen sich kombinieren. Ein Objekt kann Arrays und andere Objekte enthalten und dadurch die Struktur Ihrer tatsächlichen Daten abbilden.

import { z } from "zod";
const post = z.object({
  title: z.string(),
  tags: z.array(z.string()),
  author: z.object({ name: z.string() })
});
// Validates nested structure in one call.

Boolean und Number gemeinsam

Kombinieren Sie mehrere Feldtypen in einem Objekt-Schema, um realistische Datensätze abzubilden.

import { z } from "zod";
const product = z.object({
  name: z.string(),
  price: z.number(),
  inStock: z.boolean()
});
// product.parse({ name: "Pen", price: 2, inStock: true });

Schemas sind Werte

Ein Zod-Schema ist ein gewöhnlicher JavaScript-Wert, den Sie speichern, weitergeben und wiederverwenden können. Ein TypeScript-Typ hingegen existiert nur zur Kompilierungszeit.

import { z } from "zod";
const emailSchema = z.string();
function check(s: typeof emailSchema, v: unknown) {
  return s.parse(v);
}
// You can pass schemas as arguments.

Unbekannte Eingaben validieren

Zod eignet sich ideal für Daten vom Typ unknown, etwa einen geparsten JSON-Payload, da es den Wert sowohl prüft als auch sicher eingrenzt.

import { z } from "zod";
const schema = z.object({ id: z.number() });
const raw: unknown = JSON.parse("{ \"id\": 1 }");
const data = schema.parse(raw); // data.id is number

Bausteine für den Kurs

Mit z.object, z.string, z.number, z.array und z.boolean können Sie die meisten Daten beschreiben. Als Nächstes leiten wir aus diesen Schemas TypeScript-Typen ab.

import { z } from "zod";
const schema = z.object({
  name: z.string(),
  scores: z.array(z.number())
});
// One schema, ready to validate and to infer a type from.

Kurzer Check: Zod-Grundlagen

Testen Sie Ihr Verständnis der Grundlagen von Zod-Schemas.

Zusammenfassung: Zod-Schema-Grundlagen

Sie haben gelernt, z zu importieren, mit z.object, z.string, z.number, z.array und z.boolean Schemas zu erstellen und anschließend Werte zur Laufzeit mit .parse zu validieren.

import { z } from "zod";
const userSchema = z.object({ name: z.string(), age: z.number() });
// userSchema.parse({ name: "Ada", age: 36 });

Häufig gestellte Fragen

Ist die Lektion „Grundlagen von Zod-Schemas“ kostenlos?

Ja — der vollständige Text von „Grundlagen von Zod-Schemas“ 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 „Grundlagen von Zod-Schemas“?

Definieren Sie Schemas für primitive Typen, Objekte und Arrays. 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 1 von 4.

Wie lange dauert die Lektion „Grundlagen von Zod-Schemas“?

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

← Zurück zu TypeScript Academy