Router-Handler, Request-/Response-Typisierung
Typisieren Sie Express-Route-Handler: Parameter, Abfragen und JSON-Bodys; senden Sie typisierte Antworten mit res.json und wiederverwendbaren DTOs.
Router-Handler, Request-/Response-Typisierung ist eine kostenlose TypeScript Academy-Lektion auf CoddyKit. Dies ist Lektion 1 von 3. Du kannst die komplette Lektion unten kostenlos lesen – dann übst du sie direkt im Browser mit einem integrierten Code-Editor und einem KI-Tutor rund um die Uhr. Sie ist Teil des TypeScript Academy-Lernpfads, und dein Fortschritt wird über Web und CoddyKit-App synchronisiert. Der TypeScript Academy-Kurs umfasst insgesamt 3 Lektionen.
Einführung
Ziel: Binden Sie eine kleine Express-API mit strikter Typisierung an. Sie typisieren Routen-params, query und JSON bodies und geben anschließend typisiertes JSON mit res.json zurück.
- DTO-Interfaces
Request<P, Res, Body, Q>- Typisiertes
res.json
Servereinrichtung
Initialisieren Sie Express und aktivieren Sie das JSON-Parsing. Halten Sie den Health-Endpunkt klein und typisieren Sie ihn mit 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"))Params und Query
Typisieren Sie jeden Slot explizit: Params, Query und ResBody. Autovervollständigung hilft, Tippfehler zu vermeiden.
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)
}Typisierter Body und res
Annotieren Sie den Body für POST/PUT sowie eine typisierte Response. Ihre DTOs dienen gleichzeitig als Dokumentation.
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)
}Routen verbinden
Stellen Sie kleine, typisierte Handler zusammen. Routen-Params werden durch Abgleich mit dem Template validiert (z. B. :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"))Tipps
Tipps:
- Halten Sie DTOs klein und verwenden Sie sie in mehreren Handlern wieder.
- Bevorzugen Sie Union-Literale für eingeschränkte Query-Werte.
- Geben Sie präzise Statuscodes und typisiertes JSON zurück.
Prüfung der Express-Typisierung
Schnelltest: Wie typisieren Sie einen Express-Handler mit Params und JSON-Body?
Zusammenfassung
Zusammenfassung: Sie haben Routen-Params, Querys, Bodys und Responses typisiert. Dasselbe Muster lässt sich auf Router und Middlewares übertragen.
Häufig gestellte Fragen
Ist die Lektion „Router-Handler, Request-/Response-Typisierung“ kostenlos?
Ja — der vollständige Text von „Router-Handler, Request-/Response-Typisierung“ ist hier im Web kostenlos zu lesen. Um sie interaktiv zu üben (integrierter Code-Editor und 24/7 KI-Tutor) und den Rest des TypeScript Academy-Kurses freizuschalten, upgrade auf CoddyKit PRO. Der TypeScript Academy-Kurs umfasst insgesamt 3 Lektionen.
Was lerne ich in „Router-Handler, Request-/Response-Typisierung“?
Typisieren Sie Express-Route-Handler: Parameter, Abfragen und JSON-Bodys; senden Sie typisierte Antworten mit res.json und wiederverwendbaren DTOs. Du übst TypeScript Academy mit praktischem Code, den du direkt im Browser ausführst, und ein 24/7 KI-Tutor beantwortet deine Fragen während du die Lektion bearbeitest.
Brauche ich Erfahrung, um TypeScript Academy zu starten?
Keine Vorkenntnisse erforderlich. TypeScript Academy auf CoddyKit ist für Anfänger bis fortgeschrittene Lernende strukturiert, sodass du hier starten oder von Anfang an beginnen und in deinem eigenen Tempo voranschreiten kannst. Dies ist Lektion 1 von 3.
Wie lange dauert die Lektion „Router-Handler, Request-/Response-Typisierung“?
Die meisten CoddyKit-Lektionen dauern etwa 5–10 Minuten. Jede ist kompakt und interaktiv, sodass du stetig Fortschritte machst und genau dort weitermachst, wo du aufgehört hast – im Web und in der App.
Kann ich in dieser TypeScript Academy-Lektion Code schreiben und ausführen?
Ja. Jede TypeScript Academy-Lektion enthält einen integrierten Code-Editor, sodass du echten Code direkt in deinem Browser schreibst und ausführst und sofort KI-Feedback erhältst — ohne lokale Einrichtung erforderlich.
Alle Lektionen in diesem Kurs
- Router-Handler, Request-/Response-Typisierung
- Schema-Validierung mit zod und Inferenz nach TS
- Fehler-Middleware und Result-Typen