Tipagem de manipuladores de rotas e Request/Response
Tipifique manipuladores de rotas do Express: parâmetros, consulta e corpos JSON; envie respostas tipadas com res.json e DTOs reutilizáveis.
Tipagem de manipuladores de rotas e Request/Response é uma aula grátis de TypeScript Academy no CoddyKit. Esta é a aula 1 de 3. 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 3 aulas no total.
Introdução
Objetivo: conecte uma pequena API Express com tipos rigorosos. Você tipificará os parâmetros da rota, a consulta e os corpos JSON, e depois retornará JSON tipado com res.json.
- Interfaces DTO
Request<P, Res, Body, Q>res.jsontipado
Configuração do servidor
Inicialize o Express e ative a análise de JSON. Mantenha a rota de verificação de saúde pequena e tipada com Request/Response.
import express, { Request, Response } from "express"
const app = express()
app.use(express.json())
app.get("/", (_req: Request, res: Response) => {
res.type("text/plain").send("OK")
})
app.listen(3000, () => console.log("http://localhost:3000"))Parâmetros e consulta
Tipifique cada posição explicitamente: parâmetros, consulta e ResBody. O preenchimento automático ajuda a evitar erros de digitação.
import { Request, Response } from "express"
type Params = { id: string }
type Query = { verbose?: "1" | "0" }
type ResBody = { id: string; name: string; details?: string }
export function getUser(req: Request<Params, ResBody, unknown, Query>, res: Response<ResBody>) {
const { id } = req.params
const { verbose } = req.query
const body: ResBody = { id, name: "Ada", details: verbose === "1" ? "Loves math" : undefined }
return res.status(200).json(body)
}body e resposta tipados
Faça uma anotação para o body em POST/PUT e também para uma resposta tipada. Seus DTOs também servem como documentação.
import { Request, Response } from "express"
type CreateUserBody = { name: string }
type CreateUserRes = { id: string; name: string }
export function createUser(req: Request<{}, CreateUserRes, CreateUserBody>, res: Response<CreateUserRes>) {
const { name } = req.body
const result: CreateUserRes = { id: "u_1", name }
return res.status(201).json(result)
}Conexão das rotas
Componha manipuladores pequenos e tipados. Os parâmetros da rota são validados pela correspondência com o modelo (por exemplo, :id).
import express from "express"
import { getUser } from "./getUser"
import { createUser } from "./createUser"
const app = express()
app.use(express.json())
app.get("/users/:id", getUser)
app.post("/users", createUser)
app.listen(3000, () => console.log("http://localhost:3000"))Dicas
Dicas:
- Mantenha os DTOs pequenos e reutilize-os entre os manipuladores.
- Prefira literais de união para valores restritos da consulta.
- Retorne códigos de status precisos e JSON tipado.
Verificação da tipagem do Express
Verificação rápida: como tipificar um manipulador do Express com parâmetros e corpo JSON?
Recapitulação
Recapitulação: você tipificou os parâmetros das rotas, as consultas, os corpos e as respostas. O mesmo padrão pode ser aplicado a roteadores e camadas intermediárias.
Aprenda TypeScript com um tutor de IA — grátis
Escreva e execute código real no seu navegador, obtenha ajuda instantânea de um tutor de IA 24/7 e continue de onde parou na web ou no app.
- Cursos
- 101
- Aulas
- 352
Perguntas Frequentes
A aula “Tipagem de manipuladores de rotas e Request/Response” é grátis?
Sim — o texto completo de “Tipagem de manipuladores de rotas e Request/Response” é 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 3 aulas no total.
O que vou aprender em “Tipagem de manipuladores de rotas e Request/Response”?
Tipifique manipuladores de rotas do Express: parâmetros, consulta e corpos JSON; envie respostas tipadas com res.json e DTOs reutilizáveis. 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 1 de 3.
Quanto tempo leva a aula “Tipagem de manipuladores de rotas e Request/Response”?
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
- Tipagem de manipuladores de rotas e Request/Response
- Validação de esquemas com zod e inferência para TS
- Middleware de erros e tipos de resultado