0Pricing
TypeScript Academy · Leçon

Types des gestionnaires de route et de Request/Response

Typez les gestionnaires de routes Express : paramètres, requête et corps JSON ; envoyez des réponses typées avec res.json et des DTO réutilisables.

Types des gestionnaires de route et de Request/Response est une leçon TypeScript Academy gratuite sur CoddyKit. Ceci est la leçon 1 sur 3. Tu peux lire la leçon complète ci-dessous gratuitement — puis la pratiquer en direct dans le navigateur avec un éditeur de code intégré et un tuteur IA 24/7. Elle fait partie du parcours d'apprentissage TypeScript Academy, et ta progression se synchronise sur le web et l'application CoddyKit. Le cours TypeScript Academy comprend 3 leçons au total.

Introduction

Objectif : connectez une petite API Express avec des types stricts. Vous typerez les paramètres de route, la requête et les corps JSON, puis renverrez du JSON typé avec res.json.

  • Interfaces DTO
  • Request<P, Res, Body, Q>
  • res.json typé

Configuration du serveur

Initialisez Express et activez l’analyse du JSON. Gardez le point de terminaison de surveillance petit et typé avec 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"))

Paramètres et requête

Typez explicitement chaque emplacement : paramètres, requête et ResBody. La complétion automatique aide à éviter les fautes de frappe.

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

Corps et réponse typés

Annotez le body pour POST/PUT, ainsi qu’une réponse typée. Vos DTO servent aussi de documentation.

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

Connecter les routes

Composez de petits gestionnaires typés. Les paramètres de route sont validés par la correspondance avec le modèle (par exemple, :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"))

Conseils

Conseils :

  • Gardez les DTO petits et réutilisez-les entre les gestionnaires.
  • Préférez les littéraux d’union pour les valeurs de requête contraintes.
  • Renvoyez des codes d’état précis et du JSON typé.

Vérification du typage Express

Vérification rapide : comment typer un gestionnaire Express avec des paramètres et un corps JSON ?

Récapitulatif

Récapitulatif : vous avez typé les paramètres de route, les requêtes, les corps et les réponses. Le même modèle s’étend aux routeurs et aux intergiciels.

Questions Fréquemment Posées

La leçon « Types des gestionnaires de route et de Request/Response » est-elle gratuite ?

Oui — le texte complet de « Types des gestionnaires de route et de Request/Response » est gratuit à lire ici sur le web. Pour la pratiquer de manière interactive (un éditeur de code intégré et un tuteur IA 24/7) et déverrouiller le reste du cours TypeScript Academy, passe à CoddyKit PRO. Le cours TypeScript Academy comprend 3 leçons au total.

Qu'est-ce que j'apprendrai dans « Types des gestionnaires de route et de Request/Response » ?

Typez les gestionnaires de routes Express : paramètres, requête et corps JSON ; envoyez des réponses typées avec res.json et des DTO réutilisables. Tu pratiques TypeScript Academy avec du code pratique que tu exécutes directement dans le navigateur, et un tuteur IA 24/7 répond à tes questions au fur et à mesure que tu avances dans la leçon.

Dois-je avoir de l'expérience pour commencer TypeScript Academy ?

Aucune expérience préalable n'est requise. TypeScript Academy sur CoddyKit est structuré pour les débutants jusqu'aux apprenants avancés, donc tu peux commencer ici ou depuis le début et avancer à ton rythme. Ceci est la leçon 1 sur 3.

Combien de temps prend la leçon « Types des gestionnaires de route et de Request/Response » ?

La plupart des leçons CoddyKit prennent environ 5–10 minutes. Chacune est courte et interactive, tu progresses régulièrement et tu repiques exactement où tu t'es arrêté sur le web et l'app.

Peux-tu écrire et exécuter du code dans cette leçon TypeScript Academy ?

Oui. Chaque leçon TypeScript Academy inclut un éditeur de code intégré, tu écris et exécutes du vrai code directement dans ton navigateur et tu reçois des retours IA instantanés — aucune configuration locale requise.

Toutes les leçons de ce cours

  1. Types des gestionnaires de route et de Request/Response
  2. Validation de schémas avec zod et inférence vers TS
  3. Middleware d’erreurs et types Result
← Retour à TypeScript Academy