Framework · Desde 2017

NestJS · Express

NestJS é um framework TypeScript para servidores Node.js com módulos e injeção de dependência, que roda sobre o Express, o framework web minimalista.

Começar o guia Discussões

Express é o framework web mais usado para Node.js. Ele oferece um núcleo pequeno de roteamento e middleware e deixa a estrutura da aplicação por sua conta. O NestJS, lançado em 2017, é um framework de servidor baseado em TypeScript e decorators que traz módulos, controllers, providers e injeção de dependência. O Nest delega o tratamento de HTTP a um adaptador de plataforma, que por padrão é o Express; assim, uma aplicação Nest funciona internamente como um servidor Express e pode usar middleware do Express diretamente.

O Express combina com APIs pequenas, protótipos e projetos em que você quer definir a estrutura por conta própria. O NestJS mostra seu valor quando o código e a equipe crescem: APIs REST e GraphQL de longa duração, microsserviços e servidores em tempo real. Pipes validam a entrada, guards cuidam da autorização, e o framework se integra naturalmente a testes com Jest e a ORMs como TypeORM e Prisma.

Com o Node.js instalado, o Express exige apenas npm install express e algumas linhas de código. Para o NestJS, crie um projeto com a Nest CLI e leia a documentação oficial a partir de First steps. Entender antes as requisições, respostas e middleware do Express ajuda a perceber o que o Nest acrescenta.

Destaques

Módulos e injeção de dependência

Divida as funcionalidades em módulos e receba providers, como services, pelo construtor, reduzindo o acoplamento e facilitando os testes.

Decorators declarativos

Declare rotas e entradas com decorators como @Controller, @Get e @Body, e adicione lógica transversal com pipes, guards e interceptors.

Roda sobre o Express

O Express é a plataforma HTTP padrão, então seu ecossistema de middleware funciona como está, e é possível trocar para o Fastify quando necessário.

Um núcleo Express enxuto

Usado sozinho, o Express oferece um núcleo pequeno de roteamento e middleware para criar servidores rapidamente com a estrutura que você preferir.

Onde é usada

Servidores de APIs REST e GraphQL
Microsserviços e serviços orientados a mensagens
Servidores em tempo real com WebSockets
Backends para aplicativos web e mobile

Instalação

1
Preparar o Node.js
Tanto o NestJS quanto o Express rodam sobre o Node.js. Instale a versão LTS pelo nodejs.org e confira se node e npm mostram suas versões.
```
node --version && npm --version
```
2
Instalar a Nest CLI
Instale a ferramenta oficial de linha de comando que cria projetos e gera código. Se for usar só o Express, pule esta etapa e rode npm install express na pasta do projeto.
```
npm i -g @nestjs/cli
```
3
Criar o primeiro projeto
Crie um novo projeto e inicie o servidor de desenvolvimento em modo watch. A CLI pergunta qual gerenciador de pacotes usar; ao final, a aplicação responde em http://localhost:3000.
```
nest new hello-nest && cd hello-nest && npm run start:dev
```

Seu primeiro programa

O primeiro projeto

Um projeto criado com nest new já traz este controller. @Controller() registra a classe como controller, e @Get() liga as requisições GET na rota raiz ao método getHello. O AppService é injetado pelo construtor, enquanto src/main.ts cria a aplicação a partir do AppModule e escuta na porta 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

Ferramentas do dia a dia

Nest CLI: A ferramenta oficial de linha de comando para criar projetos, gerar controllers, services e módulos, compilar e executar em modo watch.
Jest: O framework de testes configurado por padrão em projetos Nest, usado com @nestjs/testing para testes unitários.
Supertest: Uma biblioteca que envia requisições a um servidor HTTP e verifica as respostas, usada nos testes end-to-end de aplicações Nest e Express.
TypeORM: Um ORM que mapeia classes de entidade para tabelas do banco de dados, integrado oficialmente ao Nest pelo pacote @nestjs/typeorm.

Guia passo a passo

Seis capítulos que levam você da instalação aos conceitos essenciais de NestJS · Express.

Documentação oficial e recursos

Linguagens

Discussões

Iniciar uma discussão

Tire dúvidas, compartilhe experiências e troque opiniões sobre NestJS · Express.

Ainda não há discussões. Comece a primeira.