0Pricing
TypeScript Academy · 课时

为 Express 请求与响应添加类型

扩展 Express 类型，为路由参数和请求体添加类型

为 Express 请求与响应添加类型 是 CoddyKit 上的免费 TypeScript Academy 课时。 这是第 2 节课，共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 TypeScript Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 TypeScript Academy 课程共包含 4 节课。

欢迎

Express 通过 @types/express 提供 TypeScript 类型。学习如何使路由具有类型安全性。

安装类型

安装 Express 及其类型定义。
npm install express
npm install --save-dev @types/express

基本路由类型

从 express 导入 Request 和 Response。
import { Request, Response } from 'express';
app.get('/users', (req: Request, res: Response) => {
  res.json({ users: [] });
});

带类型的路由参数

使用 Request 上的泛型为路径参数添加类型。
interface Params { id: string; }
app.get('/users/:id', (req: Request<Params>, res: Response) => {
  const { id } = req.params;
});

带类型的请求体

使用 RequestBody 泛型为请求体添加类型。
interface CreateUser { name: string; email: string; }
app.post('/users', (req: Request<{}, {}, CreateUser>, res: Response) => {
  const { name, email } = req.body;
});

带类型的查询参数

为查询字符串参数添加类型。
interface Query { page?: string; limit?: string; }
app.get('/users', (req: Request<{}, {}, {}, Query>, res: Response) => {
  const page = parseInt(req.query.page ?? '1');
});

扩展 Request

通过模块扩充为 Request 添加自定义属性。
declare global {
  namespace Express {
    interface Request { user?: User; }
  }
}

带类型的响应

在 Response 上链接泛型，为 JSON 请求体添加类型。
app.get('/me', (req: Request, res: Response<User>) => {
  res.json(req.user!); // response body must be User
});

错误处理程序类型

Express 错误处理程序具有特定的四参数签名。
import { ErrorRequestHandler } from 'express';
const errHandler: ErrorRequestHandler = (err, req, res, next) => {
  res.status(500).json({ error: err.message });
};

使用带类型的 Router

像为主应用一样为 Router 添加类型。
import { Router } from 'express';
const router = Router();
router.get('/:id', (req: Request<{ id: string }>, res) => {});

验证中间件

使用带类型的中间件验证并缩小请求类型范围。
function parseBody<T>(schema: ZodSchema<T>) {
  return (req: Request, res: Response, next: NextFunction) => {
    req.body = schema.parse(req.body);
    next();
  };
}

快速检查

在 TypeScript 项目中使用 @types/express 的主要好处是什么？

回顾

为 Express Request 和 Response 添加类型：为参数、请求体和查询指定 Request/Response 泛型。通过模块扩充扩展 Request，以添加自定义属性。使用特定签名为中间件和错误处理程序添加类型。

常见问题解答

「为 Express 请求与响应添加类型」课时是免费的吗？

是的 — 「为 Express 请求与响应添加类型」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 TypeScript Academy 课程的其余内容，请升级到 CoddyKit PRO。 TypeScript Academy 课程共包含 4 节课。

「为 Express 请求与响应添加类型」这节课中我会学到什么？

扩展 Express 类型，为路由参数和请求体添加类型 你通过在浏览器中直接运行的动手代码来练习 TypeScript Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 TypeScript Academy 需要有经验吗？

无需任何先前经验。CoddyKit 上的 TypeScript Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。 这是第 2 节课，共 4 节。

「为 Express 请求与响应添加类型」课时需要多长时间？

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。

我能在这节 TypeScript Academy 课中编写并运行代码吗？

能。每节 TypeScript Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

  1. 使用 Node.js 配置 TypeScript
  2. 为 Express 请求与响应添加类型
  3. 带类型的中间件与错误处理器
  4. 环境变量与配置类型
← 返回 TypeScript Academy