0Pricing
TypeScript Academy · Aula

Validação em tempo de execução com zod (introdução)

Valide respostas JSON em tempo de execução com esquemas zod para garantir segurança além dos tipos em tempo de compilação.

Validação em tempo de execução com zod (introdução) é uma aula grátis de TypeScript Academy no CoddyKit. Esta é a aula 2 de 2. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de TypeScript Academy, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de TypeScript Academy inclui 2 aulas no total.

Introdução

Objetivo: adicione segurança em tempo de execução com zod. Os tipos em tempo de compilação não são suficientes; por isso, os esquemas validam dados reais.

Instalar zod

Instale zod, uma biblioteca popular de validação de esquemas em tempo de execução para TS/JS.

npm install zod

Definição de esquema

Crie esquemas com z.object(). Use z.infer<typeof Schema> para gerar tipos de TS a partir dos esquemas.

import { z } from "zod";

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

type User = z.infer<typeof UserSchema>;

Schema.parse()

Chame Schema.parse() para validar os dados. Um erro será lançado se o JSON não corresponder ao esquema.

async function getUser() {
  const res = await fetch("/user.json");
  const raw = await res.json();
  const parsed = UserSchema.parse(raw);
  console.log(parsed.id, parsed.name);
}

safeParse

safeParse retorna um objeto com os campos success e error. É mais seguro do que lançar exceções.

const result = UserSchema.safeParse(raw);
if (!result.success) {
  console.error(result.error);
} else {
  console.log(result.data);
}

Esquema aninhado

Os esquemas podem ser aninhados: matrizes, objetos, campos opcionais etc.

const PostSchema = z.object({
  id: z.number(),
  title: z.string(),
  tags: z.array(z.string())
});

const raw = { id: 1, title: "Hello", tags: ["ts", "zod"] };
const post = PostSchema.parse(raw);

Verificação da validação

Verificação rápida: por que usar a validação do zod depois de analisar o JSON?

Recapitulação

Recapitulação: os esquemas do zod validam JSON em tempo de execução. Use parse ou safeParse para garantir a segurança.

Perguntas Frequentes

A aula “Validação em tempo de execução com zod (introdução)” é grátis?

Sim — o texto completo de “Validação em tempo de execução com zod (introdução)” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de TypeScript Academy, atualize para CoddyKit PRO. O curso de TypeScript Academy inclui 2 aulas no total.

O que vou aprender em “Validação em tempo de execução com zod (introdução)”?

Valide respostas JSON em tempo de execução com esquemas zod para garantir segurança além dos tipos em tempo de compilação. Você pratica TypeScript Academy com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.

Preciso ter experiência prévia para começar TypeScript Academy?

Nenhuma experiência prévia é necessária. TypeScript Academy no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 2 de 2.

Quanto tempo leva a aula “Validação em tempo de execução com zod (introdução)”?

A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.

Posso escrever e executar código nesta aula de TypeScript Academy?

Sim. Cada aula de TypeScript Academy inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.

Todas as aulas deste curso

  1. Tipos da API Fetch; genéricos de Response.json()
  2. Validação em tempo de execução com zod (introdução)
← Voltar para TypeScript Academy