• 迁移指南
    • 中间件
    • 拦截器
    • 平台
    • 元数据相关
    • GraphQL
    • Express实例
    • 弃用
    • TypeScript
    • 译者署名

    迁移指南

    本文提供了一套从 v5 迁移到最新 v6 版本的指导原则。尽管我们试图减少一些重大变化，但必须在几个地方修改 API 以简化其使用。

    中间件

    基于此主题，中间件 API 已经更改，以便来自不同 Node 库的人员更直接使用，并减少先前 API 产生的混淆。

    1. // Before
    2. @Injectable()
    3. export class LoggerMiddleware implements NestMiddleware {
    4.  resolve(...args: any[]): MiddlewareFunction {
    5.    return (req: Request, res: Response, next: Function) => {
    6.      console.log('Request...');
    7.      next();
    8.    };
    9.  }
    10. }
    12. // After
    13. @Injectable()
    14. export class LoggerMiddleware implements NestMiddleware {
    15.   use(req: Request, res: Response, next: Function) {
    16.     console.log('Request...');
    17.     next();
    18.   }
    19. }

    因此，该 with() 方法 MiddlewareConsumer 将不再起作用（完全无用）。如果要将选项传递给中间件类，请使用自定义提供程序或在此处查看更多示例。

    拦截器

    拦截器 API 也已简化。此外，由于社区报告此问题，因此需要进行更改。

    1. // Before
    2. @Injectable()
    3. export class TransformInterceptor implements NestInterceptor {
    4.   intercept(
    5.     context: ExecutionContext,
    6.     call$: Observable<T>,
    7.   ): Observable<Response<T>> {
    8.     return call$.pipe(map(data => ({ data })));
    9.   }
    10. }
    12. // After
    13. @Injectable()
    14. export class TransformInterceptor implements NestInterceptor {
    15.   intercept(
    16.     context: ExecutionContext,
    17.     next: CallHandler,
    18.   ): Observable<Response<T>> {
    19.     return next
    20.       .handle()
    21.       .pipe(map(data => ({ data })));
    22.   }
    23. }

    该 CallHandler 接口需要从 @nestjs/common 包导入。

    请注意，你的拦截器现在将以正确的顺序运行 - 它们将遵循一个简单的请求来处理管道，一旦请求想要命中一个终端处理程序，就从全局执行到具体执行，然后（在响应管道中），它们将是从特定的到全局的（如果你在其中附加一些异步/映射逻辑）执行。

    平台

    到目前为止，即使您没有使用 HTTP 服务器，也必须在内部安装 express 库（作为 @nestjs/core 软件包的依赖项）。自从新的主要版本发布以来，Nest 将不再提供这些软件包。每个平台已经提取到单个包中，分别为 @nestjs/platform-express，@nestjs/platform-fastify，@nestjs/platform-ws，和 @nestjs/platform-socket.io。假设您的应用程序同时使用 express 和 socket.io，则需安装相应的平台：

    1. $ npm i @nestjs/platform-express @nestjs/platform-socket.io

    现在，每个现有的适配器（例如 FastifyAdapter）都是从专用平台包提供的。

    • FastifyAdapter - @nestjs/platform-fastify
    • ExpressAdapter - @nestjs/platform-express
    • WsAdapter - @nestjs/platform-ws
    • IoAdapter - @nestjs/platform-socket.io

    此外，FileInterceptor（和其他 multer 相关的拦截器）现在从 @nestjs/platform-express（因为 multer 库不兼容 fastify）导出 。

    元数据相关

    该 @ReflectMetadata() 装饰已被弃用，并将在下一主要版本中删除（现在它只会显示一个警告）。请改用 @SetMetadata() 装饰器。

    GraphQL

    订阅机制已更改。检查此章的说明。此外，@nestjs/graphql 软件包严重依赖 @ReflectMetadata()（已被弃用），因此也需要更新软件包本身。

    Express实例

    我们不再支持将 express 实例作为方法的第二个参数传递 NestFactory.create() 。为了获取底层 HTTP 适配器，请使用此处描述的技术。此外，您可以传递 ExpressAdapter（只需将您的 express 实例作为构造函数参数传递 new ExpressAdapter(express)）。

    2. // Before (no longer supported)
    3. const server = express();
    4. const app = await NestFactory.create(ApplicationModule, server);
    6. // After (potential solution)
    7. const server = express();
    8. const app = await NestFactory.create(
    9.   ApplicationModule,
    10.   new ExpressAdapter(server),
    11. );

    弃用

    最终删除了所有弃用（从 4 到 5 版本）。

    TypeScript

    Nest 6 支持 TypeScript（3.0.0）的最新主要版本。

    译者署名

    用户名 头像 职能 签名
    @zuohuadong 迁移指南 - 图1 翻译 专注于 caddy 和 nest，@zuohuadong at Github
    @Drixn 迁移指南 - 图2 翻译 专注于 nginx 和 C++，@Drixn
    @Armor 迁移指南 - 图3 翻译 专注于 Java 和 Nest，@Armor