Framework · 2017 年發布

NestJS · Express

NestJS 是以 TypeScript 建構模組化、依賴注入式 Node.js 伺服器的框架，預設執行於輕量級 Web 框架 Express 之上。

Express 是 Node.js 上使用最廣泛的 Web 框架，只提供路由與中介軟體這個精簡核心，應用程式的結構交由開發者決定。NestJS 於 2017 年首次發布，是以 TypeScript 與裝飾器為基礎的伺服器框架，提供模組、控制器、提供者與依賴注入等結構。Nest 將 HTTP 處理交給平台轉接器，預設為 Express，因此 Nest 應用程式在內部就是一個 Express 伺服器，也能直接使用 Express 中介軟體。

Express 適合小型 API、原型，以及想自行設計結構的專案。NestJS 則在程式碼與團隊規模擴大時更能發揮優勢，例如需要長期維護的 REST 與 GraphQL API、微服務和即時伺服器。管道負責驗證輸入，守衛負責權限檢查，框架也能與基於 Jest 的測試，以及 TypeORM、Prisma 等 ORM 自然整合。

安裝 Node.js 後，Express 只需要 npm install express 和幾行程式碼就能開始。NestJS 建議先用 Nest CLI 建立專案，再從官方文件的 First steps 開始依序閱讀。先熟悉 Express 的請求、回應與中介軟體概念，就更容易理解 Nest 在其上增加了什麼。

特色

模組與依賴注入

將功能拆分為模組，透過建構函式注入服務等提供者，藉此降低耦合、方便測試。

宣告式裝飾器

以 @Controller、@Get、@Body 等裝飾器宣告路由與輸入，再用管道、守衛與攔截器加入共用邏輯。

執行於 Express 之上

預設 HTTP 平台是 Express，其中介軟體生態可直接沿用，必要時也能改用 Fastify。

輕量的 Express 核心

單獨使用時，Express 以路由與中介軟體這個小核心，讓你快速打造任何結構的伺服器。

適用情境

REST 與 GraphQL API 伺服器
微服務與訊息驅動的服務
以 WebSocket 打造的即時伺服器
Web 與行動應用程式的後端

安裝

1
準備 Node.js
NestJS 與 Express 都在 Node.js 上執行。從 nodejs.org 安裝 LTS 版本，並確認 node 與 npm 能顯示版本號。
```
node --version && npm --version
```
2
安裝 Nest CLI
全域安裝負責建立專案與產生程式碼的官方命令列工具。若只使用 Express，可略過此步驟，在專案資料夾中執行 npm install express。
```
npm i -g @nestjs/cli
```
3
建立第一個專案
建立新專案並以監看模式啟動開發伺服器。CLI 會詢問要使用哪個套件管理工具，完成後即可在 http://localhost:3000 看到回應。
```
nest new hello-nest && cd hello-nest && npm run start:dev
```

第一個程式

第一個專案

以 nest new 建立的專案中內建這個控制器。@Controller() 將類別註冊為控制器，@Get() 把根路徑的 GET 請求對應到 getHello 方法。AppService 透過建構函式注入，而 src/main.ts 以 AppModule 建立應用程式並在 3000 連接埠監聽。

src/app.controller.ts

import { Controller, Get } from '@nestjs/common';
import { AppService } from './app.service';

@Controller()
export class AppController {
  constructor(private readonly appService: AppService) {}

  @Get()
  getHello(): string {
    return this.appService.getHello();
  }
}

npm run start:dev

常用工具

Nest CLI: 官方命令列工具，負責建立專案，產生控制器、服務與模組，以及建置和以監看模式執行。
Jest: Nest 專案預設設定的測試框架，搭配 @nestjs/testing 撰寫單元測試。
Supertest: 向 HTTP 伺服器送出請求並檢查回應的函式庫，用於 Nest 與 Express 應用程式的端對端測試。
TypeORM: 將實體類別對應到資料庫資料表的 ORM，透過 @nestjs/typeorm 套件與 Nest 官方整合。

逐步指南

共六章，帶你從安裝一步步認識 NestJS · Express 的核心概念。

官方文件與參考資料

使用的語言

討論

發起討論

在這裡提問、分享經驗，交流關於 NestJS · Express 的看法。

還沒有討論。來發起第一則吧。

特色