React Academy · Lektion

Typesikre formularer og API-responskontrakter

Brug Zod til at udlede TypeScript-typer fra skemaer, og validér både formulardata og API-svar.

Lektion 4 af 413 trin

Typesikre formularer og API-responskontrakter er en gratis React Academy-lektion på CoddyKit. Dette er lektion 4 af 4. Du kan læse hele lektionen gratis nedenfor — og derefter øve dig praktisk i browseren med en indbygget kodeeditor og en AI-vejleder, der er tilgængelig døgnet rundt. Den er en del af læringsforløbet i React Academy, og dine fremskridt synkroniseres på tværs af nettet og CoddyKit-appen. React Academy-kurset indeholder 4 lektioner i alt.

Hvorfor typesikre dataformer er vigtige

Formularer og API-svar er grænser, hvor data kommer ind i din applikation fra kilder, du ikke kan stole på. Med Zod kan du definere skemaer, der både validerer under kørsel og udleder TypeScript-typer.

Grundlæggende Zod-skemaer

Definér skemaer med Zods flydende API. Brug z.infer<typeof schema> til at udlede TypeScript-typen.

import { z } from 'zod';

const UserSchema = z.object({
  id: z.string().uuid(),
  name: z.string().min(1).max(100),
  email: z.string().email(),
  age: z.number().int().min(0).max(150).optional(),
  role: z.enum(['admin', 'user', 'guest']),
});

type User = z.infer<typeof UserSchema>;
// { id: string; name: string; email: string; age?: number; role: 'admin'|'user'|'guest' }

React Hook Form med Zod Resolver

Integrér Zod-skemaer med React Hook Form til typesikker formularvalidering — TypeScript kender formen på formulardataene og fejlene.

import { useForm } from 'react-hook-form';
import { zodResolver } from '@hookform/resolvers/zod';

const LoginSchema = z.object({
  email: z.string().email('Invalid email'),
  password: z.string().min(8, 'At least 8 characters'),
});
type LoginData = z.infer<typeof LoginSchema>;

function LoginForm() {
  const { register, handleSubmit, formState: { errors } } = useForm<LoginData>({
    resolver: zodResolver(LoginSchema),
  });

  const onSubmit = (data: LoginData) => {
    // data is LoginData — fully typed, already validated
  };
}

Validering af API-svar

Analysér API-svar med Zod for at opdage uoverensstemmelser i formen ved grænsen — hvis API'et returnerer uventede data, får du en detaljeret fejl i stedet for et nedbrud under kørsel dybt inde i din komponent.

async function fetchUser(id: string): Promise<User> {
  const res = await fetch(`/api/users/${id}`);
  const json = await res.json();
  return UserSchema.parse(json); // throws ZodError if shape is wrong
}

Sikker parsing til kontrollerede fejl

Brug schema.safeParse() for at få et resultatobjekt i stedet for at udløse en fejl — ideelt til formularvalidering, hvor du vil vise fejl til brugeren.

const result = UserSchema.safeParse(formData);
if (!result.success) {
  const errors = result.error.flatten().fieldErrors;
  // { name: ['Must be at least 1 character'], email: ['Invalid email'] }
  return errors;
}
const user = result.data; // User — fully typed

Unioner med diskriminatorer i Zod

Brug z.discriminatedUnion til at modellere API-svar, der har forskellige strukturer afhængigt af et succes-/fejlflag.

const ApiResponse = z.discriminatedUnion('ok', [
  z.object({ ok: z.literal(true), data: UserSchema }),
  z.object({ ok: z.literal(false), error: z.string(), code: z.number() }),
]);

type ApiResult = z.infer<typeof ApiResponse>;
// { ok: true; data: User } | { ok: false; error: string; code: number }

Transformationer med Zod

Brug .transform() til at konvertere eller omforme data under fortolkningen — f.eks. konvertere en datos tekstrepræsentation til et Date-objekt.

const DateSchema = z.string().transform(s => new Date(s));
// Input: '2024-01-15' → Output: Date object

const EventSchema = z.object({
  title: z.string(),
  date: z.string().pipe(z.coerce.date()),
});
type Event = z.infer<typeof EventSchema>;
// { title: string; date: Date }

Genbrug af skemaer

Udled oprettelses- og opdateringsskemaer fra grundskemaet for at undgå duplikering.

const UserSchema = z.object({ name: z.string(), email: z.string().email() });

// For creation: add password
const CreateUserSchema = UserSchema.extend({ password: z.string().min(8) });

// For update: all fields optional
const UpdateUserSchema = UserSchema.partial();

type CreateUser = z.infer<typeof CreateUserSchema>;
type UpdateUser = z.infer<typeof UpdateUserSchema>;

Serverhandling med Zod

Validér formulardata i en serverhandling i Next.js med Zod, før du får adgang til databasen.

async function createPost(formData: FormData) {
  'use server';
  const schema = z.object({ title: z.string().min(3), body: z.string().min(10) });
  const result = schema.safeParse(Object.fromEntries(formData));
  if (!result.success) return { errors: result.error.flatten().fieldErrors };
  await db.post.create({ data: result.data });
  revalidatePath('/blog');
  redirect('/blog');
}

Delte skemaer mellem frontend og backend

Eksportér Zod-skemaer fra en delt pakke, så frontend og backend bruger den samme valideringslogik — ét skema som den eneste sandhedskilde.

// packages/schemas/src/user.ts
export const CreateUserSchema = z.object({ ... });
export type CreateUser = z.infer<typeof CreateUserSchema>;

// Frontend imports:
import { CreateUserSchema, CreateUser } from '@company/schemas';
// Backend imports:
import { CreateUserSchema } from '@company/schemas';

Zod-fejlmeddelelser

Tilpas fejlmeddelelser pr. felt for en bedre brugeroplevelse — Zod sender dem automatisk til formularens fejlvisning via resolveren.

const RegistrationSchema = z.object({
  username: z.string()
    .min(3, 'Username must be at least 3 characters')
    .max(20, 'Username cannot exceed 20 characters')
    .regex(/^[a-z0-9_]+$/, 'Only lowercase letters, numbers, and underscores'),
});

Hurtigt tjek

Hvad leverer z.infer i TypeScript?

Besvar den i den interaktive lektion

Opsummering

Definér Zod-skemaer én gang, og brug z.infer til at udlede TypeScript-typer. Brug zodResolver i React Hook Form til typesikker validering. Fortolk API-svar med Zod ved grænsen, brug safeParse til brugerrettede fejl, og del skemaer mellem frontend og backend via en delt pakke.

Gratis at komme i gang

Lær React med en AI-underviser — gratis

Skriv og kør rigtig kode i din browser, få øjeblikkelig hjælp fra en AI-underviser døgnet rundt, og fortsæt, hvor du slap, på web eller i appen.

Kurser: 88
Lektioner: 324

Start gratis Se hele kurset

Ofte stillede spørgsmål

Er lektionen “Typesikre formularer og API-responskontrakter” gratis?

Ja — hele teksten til “Typesikre formularer og API-responskontrakter” kan læses gratis her på nettet. Hvis du vil øve dig interaktivt med en indbygget kodeeditor og en AI-vejleder døgnet rundt og få adgang til resten af React Academy-kurset, skal du opgradere til CoddyKit PRO. React Academy-kurset indeholder 4 lektioner i alt.

Hvad lærer jeg i “Typesikre formularer og API-responskontrakter”?

Brug Zod til at udlede TypeScript-typer fra skemaer, og validér både formulardata og API-svar. Du øver dig i React Academy med praktisk kode, som du kører direkte i browseren, og en AI-vejleder døgnet rundt besvarer dine spørgsmål, mens du arbejder dig gennem lektionen.

Skal jeg have erfaring for at begynde på React Academy?

Der kræves ingen tidligere erfaring. React Academy på CoddyKit er tilrettelagt for både begyndere og øvede, så du kan starte her eller fra begyndelsen og lære i dit eget tempo. Dette er lektion 4 af 4.

Hvor lang tid tager lektionen “Typesikre formularer og API-responskontrakter”?

De fleste CoddyKit-lektioner tager cirka 5–10 minutter. Hver lektion er kort og interaktiv, så du gør løbende fremskridt og kan fortsætte, hvor du slap – på både web og app.

Kan jeg skrive og køre kode i denne React Academy-lektion?

Ja. Alle React Academy-lektioner har en indbygget kodeeditor, så du kan skrive og køre rigtig kode direkte i din browser og få øjeblikkelig feedback fra AI – uden lokal opsætning.

Alle lektioner i dette kursus

Diskriminerede unions til komponentvarianter
Betingede og mappede typer i React
Polymorfe komponenter med 'as'-prop
Typesikre formularer og API-responskontrakter

← Tilbage til React Academy