Hiệu năng (Performance) (Fastify)

Theo mặc định, Nest dùng framework Express. Như đã đề cập trước đó, Nest cũng cung cấp khả năng tương thích với các thư viện khác, như Fastify. Nest đạt được sự độc lập với framework này bằng cách implement một framework adapter, có nhiệm vụ chính là proxy middleware và handler tới implementation cụ thể của từng thư viện.

Fastify là một framework thay thế tốt cho Nest vì nó giải quyết các vấn đề thiết kế theo cách tương tự Express. Tuy nhiên, Fastify nhanh hơn Express đáng kể, đạt gần gấp đôi kết quả benchmark. Vậy một câu hỏi hợp lý là, tại sao Nest lại dùng Express làm HTTP provider mặc định. Lý do là vì Express được dùng rộng rãi, được biết đến nhiều, và có một tập hợp middleware tương thích khổng lồ, có sẵn cho người dùng Nest ngay khi cài đặt.

Nhưng vì Nest cung cấp sự độc lập với framework, bạn có thể dễ dàng chuyển đổi giữa hai lựa chọn này. Fastify có thể là lựa chọn tốt hơn khi tốc độ thô (raw speed) là ưu tiên hàng đầu. Để dùng Fastify, chỉ cần chọn FastifyAdapter có sẵn như trong chương này.

Cài đặt (Installation)

Đầu tiên, ta cần cài package cần thiết:

$ npm i --save @nestjs/platform-fastify

Adapter

Sau khi cài platform Fastify, ta có thể dùng FastifyAdapter.

import { NestFactory } from '@nestjs/core';
import {
  FastifyAdapter,
  NestFastifyApplication,
} from '@nestjs/platform-fastify';
import { AppModule } from './app.module.js';

async function bootstrap() {
  const app = await NestFactory.create<NestFastifyApplication>(
    AppModule,
    new FastifyAdapter()
  );
  await app.listen(process.env.PORT ?? 3000);
}
await bootstrap();

Theo mặc định, Fastify chỉ listen trên interface localhost 127.0.0.1 (đọc thêm). Nếu bạn muốn nhận connection từ các host khác, bạn nên chỉ định '0.0.0.0' trong lệnh gọi listen():

async function bootstrap() {
  const app = await NestFactory.create<NestFastifyApplication>(
    AppModule,
    new FastifyAdapter(),
  );
  await app.listen(3000, '0.0.0.0');
}

Package đặc thù theo platform (Platform specific packages)

Hãy nhớ rằng khi bạn dùng FastifyAdapter, Nest sẽ dùng Fastify làm HTTP provider. Điều này nghĩa là mỗi công thức (recipe) nào phụ thuộc vào Express có thể sẽ không còn hoạt động. Bạn nên dùng các package tương đương của Fastify thay thế.

Response redirect (Redirect response)

Fastify xử lý response redirect có khác biệt đôi chút so với Express. Để redirect đúng cách với Fastify, trả về cả status code và URL, như sau:

@Get()
index(@Res() res) {
  res.status(302).redirect('/login');
}

Option của Fastify (Fastify options)

Bạn có thể truyền option vào constructor của Fastify thông qua constructor của FastifyAdapter. Ví dụ:

new FastifyAdapter({ logger: true });

Middleware

Middleware function nhận vào req và res object thô (raw), thay vì các wrapper của Fastify. Đây là cách package middie hoạt động — package mà Fastify dùng bên dưới — xem thêm trang này để biết thêm thông tin.

import { Injectable, NestMiddleware } from '@nestjs/common';
import { FastifyRequest, FastifyReply } from 'fastify';

@Injectable()
export class LoggerMiddleware implements NestMiddleware {
  use(req: FastifyRequest['raw'], res: FastifyReply['raw'], next: () => void) {
    console.log('Request...');
    next();
  }
}

import { Injectable } from '@nestjs/common';

@Injectable()
export class LoggerMiddleware {
  use(req, res, next) {
    console.log('Request...');
    next();
  }
}

Route Config

Bạn có thể dùng tính năng route config của Fastify với decorator @RouteConfig().

@RouteConfig({ output: 'hello world' })
@Get()
index(@Req() req) {
  return req.routeConfig.output;
}

Route Constraints

Từ v10.3.0, @nestjs/platform-fastify hỗ trợ tính năng route constraints của Fastify với decorator @RouteConstraints.

@RouteConstraints({ version: '1.2.x' })
newFeature() {
  return 'This works only for version >= 1.2.x';
}

Ví dụ (Example)

Một ví dụ hoạt động thực tế có sẵn tại đây.