0Pricing
TypeScript Academy · 강의

라우터 처리기와 Request/Response 타이핑

Express 경로 처리기의 매개변수, 쿼리 및 JSON 본문에 타입을 지정하고, res.json과 재사용 가능한 DTO로 타입이 지정된 응답을 보냅니다.

라우터 처리기와 Request/Response 타이핑은(는) CoddyKit의 무료 TypeScript Academy 강의입니다. 이것은 3개 중 1번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 TypeScript Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. TypeScript Academy 강의에는 총 3개의 강의가 포함되어 있습니다.

소개

목표: 엄격한 타입이 적용된 소규모 익스프레스 API를 연결하십시오. 라우트 매개변수, 쿼리, JSON 본문에 타입을 지정한 다음 res.json으로 타입이 지정된 JSON을 반환합니다.

  • DTO 인터페이스
  • Request<P, Res, Body, Q>
  • 타입이 지정된 res.json

서버 설정

익스프레스를 초기화하고 JSON 구문 분석을 활성화하십시오. 상태 확인 엔드포인트는 작게 유지하고 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"))

매개변수와 쿼리

각 슬롯을 명시적으로 타입 지정하십시오. 매개변수, 쿼리, ResBody를 지정하면 자동 완성으로 오타를 방지할 수 있습니다.

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

타입이 지정된 본문과 응답

POST/PUT 요청의 body와 타입이 지정된 응답을 함께 선언하십시오. DTO는 문서 역할도 합니다.

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

라우트 연결

작고 타입이 지정된 처리기를 조합하십시오. 라우트 매개변수는 템플릿과 일치하는지 확인하여 검증됩니다(예: :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"))

팁

팁:

  • DTO는 작게 유지하고 여러 처리기에서 재사용하십시오.
  • 제한된 쿼리 값에는 유니언 리터럴을 우선 사용하십시오.
  • 정확한 상태 코드와 타입이 지정된 JSON을 반환하십시오.

익스프레스 타입 지정 확인

빠른 확인: 매개변수와 JSON 본문이 있는 익스프레스 처리기에 타입을 지정하려면 어떻게 해야 합니까?

복습

복습: 라우트 매개변수, 쿼리, 본문, 응답에 타입을 지정했습니다. 같은 패턴을 라우터와 미들웨어에도 확장할 수 있습니다.

자주 묻는 질문

“라우터 처리기와 Request/Response 타이핑” 강의는 무료인가요?

네 — “라우터 처리기와 Request/Response 타이핑” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 TypeScript Academy 강의 전체를 잠금 해제할 수 있습니다. TypeScript Academy 강의에는 총 3개의 강의가 포함되어 있습니다.

“라우터 처리기와 Request/Response 타이핑”에서 뭘 배우나요?

Express 경로 처리기의 매개변수, 쿼리 및 JSON 본문에 타입을 지정하고, res.json과 재사용 가능한 DTO로 타입이 지정된 응답을 보냅니다. 브라우저에서 직접 실행하는 실습 코드로 TypeScript Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

TypeScript Academy을(를) 시작하는 데 경험이 필요한가요?

사전 경험은 필요하지 않습니다. CoddyKit의 TypeScript Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 3개 중 1번째 강의입니다.

“라우터 처리기와 Request/Response 타이핑” 강의는 얼마나 걸리나요?

대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.

이 TypeScript Academy 강의에서 코드를 작성하고 실행할 수 있나요?

네. 모든 TypeScript Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.

이 강의의 모든 강의

  1. 라우터 처리기와 Request/Response 타이핑
  2. zod를 사용한 스키마 검증과 TS 추론
  3. 오류 미들웨어와 결과 타입
← TypeScript Academy(으)로 돌아가기