.ts · text/typescript

Schema Zod: Esquema de Validação em Tempo de Execução Zod

Schemas Zod combinam validação JSON em tempo de execução (`z.object`, `z.array`, `.optional()`) com inferência estática automática via `z.infer<typeof schema>`.

Resposta rápida: Schemas Zod combinam validação JSON em tempo de execução (`z.object`, `z.array`, `.optional()`) com inferência estática automática via `z.infer<typeof schema>`. Validação em bordas de API, schemas tRPC/React Hook Form e inferência estática de tipos TypeScript em fonte única.

Tipo de estruturaCódigo tipado
Legibilidade humanaAlta
Suporte a aninhamentoSim
Eficiência de tokens LLMMédia
Extensão do arquivo.ts
Tipo MIMEtext/typescript
Indicado paraValidação em bordas de API, schemas tRPC/React Hook Form e inferência estática de tipos TypeScript em fonte única.

Pontos fortes

  • Valida JSON não confiável em execução enquanto gera tipos TypeScript estáticos
  • Detecta chaves ausentes, primitivos errados e desvios de API com erros claros
  • Suporta modo estrito (.strict()) para rejeitar chaves desconhecidas

Limitações

  • Adiciona pequena sobrecarga de biblioteca em execução frente a interfaces puras
  • Schemas recursivos profundos exigem anotações manuais explícitas de tipo
  • Modo estrito pode quebrar compatibilidade futura se APIs adicionarem novos campos

Referências

Converter e limpar Schema Zod localmente

Guias técnicos relacionados

Formatos relacionados

Todos os 24 formatos

Perguntas frequentes sobre Schema Zod

Por que gerar schemas Zod em vez de simples interfaces TypeScript?

Tipos TypeScript desaparecem em execução. O Zod verifica respostas JSON reais recebidas em execução e exporta z.infer<typeof schema> automaticamente.

O que faz a opção Objetos Estritos em JSON para Zod?

Adiciona .strict() aos schemas z.object(...) gerados para que propriedades não reconhecidas lancem erro em vez de serem descartadas.

Objetos aninhados e arrays mistos são tratados automaticamente?

Sim. Estruturas aninhadas geram z.object(), z.array(), z.union() e modificadores .nullable() / .optional() de forma limpa.