TypeScript Academy · leksjon

zod/valibot-skjemaer + inferens

Valider data du ikke stoler på, med skjemaer. Utled TS-typer direkte fra validatorene, sammenlign zod og valibot, og koble dem til håndterere.

Leksjon 1 av 28 trinn

zod/valibot-skjemaer + inferens er en gratis leksjon i TypeScript Academy på CoddyKit. Dette er leksjon 1 av 2. Du kan lese hele leksjonen gratis nedenfor – og deretter øve praktisk i nettleseren med en innebygd kodeeditor og en AI-veileder som er tilgjengelig døgnet rundt. Den er en del av læringsløpet i TypeScript Academy, og fremdriften din synkroniseres mellom nettet og CoddyKit-appen. Kurset i TypeScript Academy inneholder totalt 2 leksjoner.

Introduksjon

Mål: Behandle inndata utenfra som unknown, valider med et skjema, og utled TS-typer fra skjemaet. Du skal bruke zod, se syntaksen i valibot og lage en liten hjelper for håndterere.

  • Én sannhetskilde
  • safeParse kontra parse
  • Gjenbruk utledede typer

zod-inferens

Definer et skjema én gang. type User = z.infer<typeof userSchema> gjenspeiler valideringsreglene nøyaktig.

import { z } from "zod"

export const userSchema = z.object({
  id: z.string().uuid(),
  name: z.string().min(1),
  age: z.number().int().min(0).optional()
})

export type User = z.infer<typeof userSchema>

// User is kept in sync with runtime rules.

safeParse kontra parse

safeParse gir et resultat med suksess eller feil uten å kaste et unntak, noe som passer perfekt for HTTP-håndterere; parse kaster et unntak ved ugyldige inndata.

import type { Request, Response } from "express"
import { userSchema, type User } from "./schema"

export function createUser(req: Request, res: Response<User | { error: string; issues?: unknown }>) {
  const r = userSchema.safeParse(req.body)
  if (!r.success) {
    return res.status(400).json({ error: "Invalid body", issues: r.error.format() })
  }
  const user = r.data
  return res.status(201).json(user)
}

// parse() throws; safeParse() returns a discriminated union

valibot-inferens

valibot tilbyr en kompakt validator med Infer<typeof schema>. Velg ett bibliotek og standardiser på det i hele teamet.

import { object, string, number, optional, minLength, uuid, minValue } from "valibot"
import type { Infer } from "valibot"

export const VUser = object({
  id: string([uuid()]),
  name: string([minLength(1)]),
  age: optional(number([minValue(0)]))
})

export type VUserT = Infer<typeof VUser>

// Similar idea: one schema, inferred type.

Valideringshjelper

Pakk inn parsingen i en liten hjelper slik at håndterere får en enkel struktur med { ok,data } kontra { ok:false,issues }.

import { ZodTypeAny } from "zod"

export function validate<T extends ZodTypeAny, Out = unknown>(schema: T, value: unknown, onError?: (issues: unknown) => never | void): { ok: true; data: Out } | { ok: false; issues: unknown } {
  const r = schema.safeParse(value)
  if (!r.success) {
    const issues = r.error.format()
    if (onError) onError(issues as unknown as never)
    return { ok: false, issues }
  }
  return { ok: true, data: r.data as unknown as Out }
}

Tips

Tips:

  • Hold skjemaer nær grensen (HTTP, CLI, DB IO).
  • Utled typer og eksporter dem – unngå håndskrevne duplikater.
  • Returner 400 med detaljer om problemene; stol aldri på klientinndata.

Kontroll av fordelene ved inferens

Hurtigkontroll: Hvorfor utlede typer fra skjemaer?

Oppsummering

Oppsummering: Valider ukjente inndata med zod/valibot, bruk safeParse, og utled typer for å holde kompileringstid og kjøretid i samsvar.

Gratis å komme i gang

Lær deg TypeScript med en AI-veileder – gratis

Skriv og kjør ekte kode i nettleseren, få umiddelbar hjelp fra en AI-veileder som er tilgjengelig døgnet rundt, og fortsett der du slapp – på nettet eller i appen.

Kurs
101
Leksjoner
352

Ofte stilte spørsmål

Er leksjonen «zod/valibot-skjemaer + inferens» gratis?

Ja – hele teksten i «zod/valibot-skjemaer + inferens» er gratis å lese her på nettet. For å øve interaktivt med en innebygd kodeeditor og en AI-veileder som er tilgjengelig døgnet rundt, og for å låse opp resten av TypeScript Academy-kurset, kan du oppgradere til CoddyKit PRO. Kurset i TypeScript Academy inneholder totalt 2 leksjoner.

Hva lærer jeg i «zod/valibot-skjemaer + inferens»?

Valider data du ikke stoler på, med skjemaer. Utled TS-typer direkte fra validatorene, sammenlign zod og valibot, og koble dem til håndterere. Du øver på TypeScript Academy med praktisk kode som du kjører direkte i nettleseren, mens en AI-veileder som er tilgjengelig døgnet rundt, svarer på spørsmålene dine mens du jobber deg gjennom leksjonen.

Trenger jeg erfaring for å begynne med TypeScript Academy?

Ingen tidligere erfaring er nødvendig. TypeScript Academy på CoddyKit er lagt opp for både nybegynnere og viderekomne, så De kan begynne her eller helt fra start og lære i Deres eget tempo. Dette er leksjon 1 av 2.

Hvor lang tid tar leksjonen «zod/valibot-skjemaer + inferens»?

De fleste CoddyKit-leksjoner tar omtrent 5–10 minutter. Hver leksjon er kort og interaktiv, slik at De gjør jevne fremskritt og kan fortsette akkurat der De slapp – både på nettet og i appen.

Kan jeg skrive og kjøre kode i denne TypeScript Academy-leksjonen?

Ja. Alle TypeScript Academy-leksjoner har en innebygd kodeeditor, slik at De kan skrive og kjøre ekte kode direkte i nettleseren og få umiddelbar tilbakemelding fra AI – uten lokal konfigurering.

Alle leksjonene i dette kurset

  1. zod/valibot-skjemaer + inferens
  2. Defensiv parsing og feilkonvolutter
← Tilbake til TypeScript Academy