TypeScript Academy · Lezione

Basi degli schemi Zod

Definisca schemi per primitivi, oggetti e array.

Basi degli schemi Zod è una lezione TypeScript Academy gratuita su CoddyKit. Questa è la lezione 1 di 4. Puoi leggere la lezione completa qui gratuitamente — poi esercitati direttamente nel browser con un editor di codice integrato e un tutor IA disponibile 24/7. Fa parte del percorso di apprendimento TypeScript Academy, e i tuoi progressi si sincronizzano tra il web e l'app CoddyKit. Il corso TypeScript Academy include 4 lezioni in totale.

Perché la convalida a runtime?

I tipi TypeScript scompaiono a runtime. I dati provenienti da API, moduli e file non sono tipizzati al confine del sistema. Zod convalida questi dati a runtime e fornisce anche i relativi tipi.

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

Importare Zod

Importi il namespace z dal pacchetto zod. Ogni builder di schema è disponibile tramite z.

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

Schema primitivi

Zod offre builder per i tipi primitivi: z.string(), z.number() e z.boolean() convalidano ciascuno un tipo di valore.

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

Convalidare un valore

Chiami .parse su uno schema per convalidare un valore. Restituisce il valore se è valido e genera un errore altrimenti.

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

Schema di oggetti

z.object descrive la struttura di un oggetto, associando ogni chiave a uno schema per il relativo valore.

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

Schema di array

z.array convalida che un valore sia un array i cui elementi corrispondano tutti a uno schema specificato.

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

Annidare gli schemi

Gli schemi sono componibili. Un oggetto può contenere array e altri oggetti, rispecchiando la struttura dei dati reali.

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.

Booleani e numeri insieme

Combini più tipi di campo in un unico schema di oggetto per modellare record realistici.

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 });

Gli schemi sono valori

Uno schema Zod è un normale valore JavaScript che può essere memorizzato, passato ad altre funzioni e riutilizzato, a differenza di un tipo TypeScript, che esiste solo in fase di compilazione.

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.

Convalidare input sconosciuti

Zod è ideale per dati di tipo unknown, come un payload JSON analizzato, perché controlla il valore e ne restringe il tipo in modo sicuro.

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

Elementi fondamentali del corso

Con z.object, z.string, z.number, z.array e z.boolean può descrivere la maggior parte dei dati. Ora inferiremo i tipi TypeScript da questi schemi.

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.

Verifica rapida: nozioni di base su Zod

Verifichi la Sua comprensione delle nozioni di base sugli schemi Zod.

Riepilogo: nozioni di base sugli schemi Zod

Ha imparato a importare z e a creare schemi con z.object, z.string, z.number, z.array e z.boolean, per poi convalidare i valori a runtime con .parse.

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

Domande Frequenti

La lezione «Basi degli schemi Zod» è gratuita?

Sì — il testo completo di «Basi degli schemi Zod» è gratuito qui sul web. Per esercitarvi in modo interattivo (un editor di codice integrato e un tutor IA 24/7) e sbloccare il resto del corso TypeScript Academy, passa a CoddyKit PRO. Il corso TypeScript Academy include 4 lezioni in totale.

Cosa imparerò in «Basi degli schemi Zod»?

Definisca schemi per primitivi, oggetti e array. Eserciti TypeScript Academy con codice pratico che esegui direttamente nel browser, e un tutor IA 24/7 risponde alle tue domande mentre lavori sulla lezione.

Ho bisogno di esperienza per iniziare TypeScript Academy?

Non è richiesta alcuna esperienza precedente. TypeScript Academy su CoddyKit è strutturato per principianti e studenti avanzati, quindi puoi iniziare da qui o dall'inizio e procedere al tuo ritmo. Questa è la lezione 1 di 4.

Quanto tempo richiede la lezione «Basi degli schemi Zod»?

La maggior parte delle lezioni CoddyKit richiede circa 5–10 minuti. Ogni lezione è breve e interattiva, quindi fai progressi costanti e riprendi esattamente da dove hai lasciato su web e app.

Posso scrivere ed eseguire codice in questa lezione TypeScript Academy?

Sì. Ogni lezione TypeScript Academy include un editor di codice integrato, quindi scrivi ed esegui codice reale direttamente nel tuo browser e ricevi feedback istantaneo dall'IA — nessuna configurazione locale necessaria.

Tutte le lezioni di questo corso

← Torna a TypeScript Academy