如何将 Typescript 定义添加到 Express req 和 res

Question

我有一组用于我的 REST API 的控制器函数，并且我得到了很多以下内容

error TS7006: Parameter 'req' implicitly has an 'any' type.

res 也是如此。我一直在玩打字等，但没有成功。例如下面的Request 类型参数不起作用。

以下是控制器文件的示例。参考路径正确。

/// <reference path="../../../typings/tsd.d.ts" />    
/* globals require */    
"use strict";    
exports.test = (req : Request, res) => {

我尝试将import * as express from "express"; 添加到文件中 - 我通常不需要它，因为这些函数是由实际实现路由的 index.js 导出和使用的。

这是 tsd.d.ts

/// <reference path="requirejs/require.d.ts" />
/// <reference path="express/express.d.ts" />
/// <reference path="mime/mime.d.ts" />
/// <reference path="node/node.d.ts" />
/// <reference path="serve-static/serve-static.d.ts" />
/// <reference path="bluebird/bluebird.d.ts" />
/// <reference path="mongoose/mongoose.d.ts" />

Answer 1

您可以使用 ES6 风格的命名导入来仅导入您需要的接口，而不是 import * as express from 'express'，后者会包含 express 本身。

首先，确保您已安装 express (npm install -D @types/express) 的类型定义。

例子：

// middleware/authCheck.ts
import { Request, Response, NextFunction } from 'express';

export const authCheckMiddleware = (req: Request, res: Response, next: NextFunction) => {
  ...
};

// server.ts
import { authCheckMiddleware } from './middleware/authCheck';
app.use('/api', authCheckMiddleware);

目前使用 TypeScript 2.3.4 和 @types/express 4.0.36。

Answer 2

最好的办法就是这样。

// 在你的项目中创建一些共享类型

import { Request, Response, NextFunction } from 'express';
export type MiddlewareFn = (req: Request, res: Response, next: NextFunction) => void;

//然后使用上面的类型：

import {MiddlewareFn} from './my-types.d.ts'

router.get('/foo', <MiddlewareFn>function (req, res, next) {

   // ....
});

Answer 3

每次您需要编写中间件函数时都输入参数可能会令人生畏，因此您也可以直接输入整个函数。

npm i @types/express --save-dev ("@types/express": "^4.17.0")

安装打字后..

// This can be shortened..
import { Request, Response, NextFunction } from 'express';
export const myMiddleware = (req: Request, res: Response, next: NextFunction) => {
  ...
};

// to this..
import { RequestHandler } from 'express';
export const myMiddleware: RequestHandler = (req, res, next) => {
  ...
};

// or in case it handles the error object
import { ErrorRequestHandler } from 'express';
export const myMiddleware: ErrorRequestHandler = (err, req, res, next) => {
  ...
};

Answer 4

除了安装类型（@types/express），您还应该定义请求参数。由于每个参数都是字符串，接口应该基于字典。

这是一个内联路由处理程序：

interface GetParams {
  [key: string]: string
  paramName: string
}

router.get<GetParams>('/:paramName', (req, res) => {
  res.send('Parameter is ' + req.params.paramName)
})

Answer 5

我发现您可以非常有效地利用 TypeScript 泛型来围绕 Express Request 类型创建包装器。

您可以在接口文件/文件夹中声明类似于此的内容：

import { NextFunction, Request, Response } from 'express';

type TypedRequest<
  ReqBody = Record<string, unknown>,
  QueryString = Record<string, unknown>
> = Request<
  Record<string, unknown>,
  Record<string, unknown>,
  Partial<ReqBody>,
  Partial<QueryString>
>;

export type ExpressMiddleware<
  ReqBody = Record<string, unknown>,
  Res = Record<string, unknown>,
  QueryString = Record<string, unknown>
> = (
  req: TypedRequest<ReqBody, QueryString>,
  res: Response<Res>,
  next: NextFunction
) => Promise<void> | void;

TypedRequest 实际上是 Express 的 Request 接口的包装器，并使用您传递的泛型填充它，但也是可选的（注意 Record<string, unknown>。然后它还会在每个接口周围应用 Partial泛型（您可能希望将其设为 DeepPartial）

ExpressMiddleware 接受 3 个可选泛型 ReqBody Res 和 QueryString。这些用于构造类似于中间件/控制器应该是什么样子的函数签名。

然后上面允许你强类型和消费如下：

import { ExpressMiddleware } from '../interfaces/ExpressMiddleware';

type Req = { email: string; password: string };

type Res = { message: string };

export const signupUser: ExpressMiddleware<Req, Res> = async (req, res) => {
  /* strongly typed `req.body`. yay autocomplete ? */
  res.json({ message: 'you have signed up' }) // strongly typed response obj
};

我希望这对某人有所帮助。这对我的 Express 体验产生了巨大的影响。

Answer 6

用途：

req: Express.Request
res: Express.Response