0Pricing
TypeScript Academy · Lekcja

Schematy zod/valibot i inferencja

Walidujcie niezaufane dane za pomocą schematów; wyprowadzajcie typy TS bezpośrednio z walidatorów; porównajcie zod i valibot oraz zintegrujcie je z handlerami.

Schematy zod/valibot i inferencja to bezpłatna lekcja TypeScript Academy na CoddyKit. To lekcja 1 z 2. Możesz przeczytać całą lekcję poniżej za darmo — a potem ćwiczyć ją interaktywnie w przeglądarce z wbudowanym edytorem kodu i tutorem AI dostępnym 24/7. To część ścieżki edukacyjnej TypeScript Academy, a Twój postęp synchronizuje się między webem a aplikacją CoddyKit. Kurs TypeScript Academy zawiera 2 lekcji w sumie.

Wprowadzenie

Cel: Traktuj dane wejściowe z zewnątrz jako unknown, sprawdzaj je za pomocą schematu i inferuj typy TS na podstawie tego schematu. Użyjesz zod, poznasz składnię valibot i utworzysz niewielki helper dla handlerów.

  • Jedno źródło prawdy
  • safeParse a parse
  • Ponowne używanie wyinferowanych typów

Inferowanie za pomocą zod

Zdefiniuj schemat tylko raz. type User = z.infer<typeof userSchema> dokładnie odzwierciedla reguły walidacji.

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 a parse

safeParse zwraca wynik informujący o powodzeniu lub niepowodzeniu bez zgłaszania wyjątku, dlatego świetnie nadaje się do handlerów HTTP; parse zgłasza wyjątek dla nieprawidłowych danych wejściowych.

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

Inferowanie za pomocą valibot

valibot oferuje zwięzły walidator z użyciem Infer<typeof schema>. Wybierz jedną bibliotekę i ustandaryzuj jej użycie w całym zespole.

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.

Helper walidacji

Opakuj analizowanie danych w niewielkim helperze, aby handlery otrzymywały prostą strukturę { ok,data } lub { 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 }
}

Wskazówki

Wskazówki:

  • Trzymaj schematy blisko granicy systemu (HTTP, CLI, operacje wejścia-wyjścia bazy danych).
  • Inferuj typy i eksportuj je — unikaj ręcznego powielania definicji.
  • Zwracaj 400 ze szczegółami problemów; nigdy nie ufaj danym wejściowym klienta.

Sprawdzenie korzyści z inferowania

Szybkie sprawdzenie: Dlaczego należy inferować typy na podstawie schematów?

Podsumowanie

Podsumowanie: Waliduj dane wejściowe typu unknown za pomocą zod/valibot, używaj safeParse i inferuj typy, aby zachować zgodność między czasem kompilacji a czasem działania.

Często zadawane pytania

Czy lekcja „Schematy zod/valibot i inferencja” jest bezpłatna?

Tak — pełny tekst „Schematy zod/valibot i inferencja” jest dostępny za darmo tutaj w sieci. Aby ćwiczyć ją interaktywnie (wbudowany edytor kodu i tutor AI dostępny 24/7) i odblokować resztę kursu TypeScript Academy, przejdź na CoddyKit PRO. Kurs TypeScript Academy zawiera 2 lekcji w sumie.

Co nauczysz się w „Schematy zod/valibot i inferencja”?

Walidujcie niezaufane dane za pomocą schematów; wyprowadzajcie typy TS bezpośrednio z walidatorów; porównajcie zod i valibot oraz zintegrujcie je z handlerami. Ćwiczysz TypeScript Academy z praktycznym kodem, który uruchamiasz bezpośrednio w przeglądarce, a tutor AI dostępny 24/7 odpowiada na Twoje pytania podczas pracy nad lekcją.

Czy potrzebuję doświadczenia, aby zacząć TypeScript Academy?

Nie wymagamy żadnego doświadczenia. TypeScript Academy w CoddyKit jest strukturyzowany dla początkujących i zaawansowanych użytkowników, więc możesz zacząć tutaj lub od początku i uczyć się w swoim tempie. To lekcja 1 z 2.

Ile czasu zajmuje lekcja „Schematy zod/valibot i inferencja”?

Większość lekcji CoddyKit trwa około 5–10 minut. Każda lekcja to mały, interaktywny krok, dzięki czemu robisz systematyczne postępy i zawsze wracasz dokładnie do tego samego miejsca — na webie i w aplikacji.

Czy mogę pisać i uruchamiać kod w tej lekcji TypeScript Academy?

Tak. Każda lekcja TypeScript Academy zawiera wbudowany edytor kodu, więc piszesz i uruchamiasz prawdziwy kod bezpośrednio w przeglądarce i od razu otrzymujesz sprzężenie zwrotne od AI — bez konfiguracji na komputerze.

Wszystkie lekcje w tym kursie

  1. Schematy zod/valibot i inferencja
  2. Defensywne parsowanie i koperty błędów
← Powrót do TypeScript Academy