Converter JSON para TypeScript: Guia de Tipos e Interfaces

# Converter JSON para TypeScript: Guia de Tipos e Interfaces

Converter dados JSON em tipos TypeScript é fundamental para garantir a segurança do código, permitindo que o editor de código (como o VS Code) ofereça autocompletar e detecção de erros em tempo real.

Exemplo Rápido

Dado JSON:

{
  "id": 1,
  "nome": "Alice",
  "ativo": true
}

Interface TypeScript correspondente:

interface Usuario {
  id: number;
  nome: string;
  ativo: boolean;
}

---

Ferramentas de Conversão Automática

Não perca tempo criando interfaces gigantes manualmente. Use ferramentas como:

• quicktype.io: A ferramenta mais completa para gerar tipos a partir de JSON e até de URLs de APIs.
• JSON to TS (Extensão do VS Code): Permite colar um JSON e transformá-lo em interface instantaneamente dentro do editor.

Lidando com Campos Opcionais

Muitas APIs nem sempre retornam todos os campos. Use a interrogação (?) para marcar campos que podem vir vazios:

interface Usuario {
  nome: string;
  sobrenome?: string; // Este campo é opcional
}

---

Validação com Zod

Tipos TypeScript somem depois que o código é compilado. Para garantir que os dados de uma API são realmente o que você espera em tempo de execução, use a biblioteca Zod:

import { z } from 'zod';

const EsquemaUsuario = z.object({
  id: z.number(),
  nome: z.string()
});

// Valida os dados reais vindos da API
const dadosValidados = EsquemaUsuario.parse(dadosVindosDaApi);

Conclusão

A integração entre JSON e TypeScript torna o desenvolvimento front-end e back-end muito mais robusto. Comece gerando seus tipos automaticamente e use ferramentas de validação para criar aplicações à prova de erros.