Le point d'entrée main.ts et le démarrage de l'application (NestFactory)

La fonction bootstrap

« Bootstrap » signifie amorçage. Cette fonction est asynchrone (async) car la création de l'application et le démarrage du serveur prennent du temps : on les attend avec await.

NestFactory lit les modules, crée les objets, puis on configure l'application avant de la mettre à l'écoute.

NestFactory.create

NestFactory.create(AppModule) parcourt le module racine et tous les modules importés, crée les services et les contrôleurs, résout l'injection de dépendances, puis renvoie l'objet app. Si une dépendance manque, c'est ici que l'erreur apparaît.

Un second paramètre facultatif accepte des options :

const app = await NestFactory.create(AppModule, {
  logger: ['error', 'warn', 'log'],   // niveaux de journalisation affichés
  cors: true,                          // autre façon d'activer CORS
});

Le préfixe global

Une API expose généralement toutes ses routes sous /api. Plutôt que de l'écrire dans chaque contrôleur :

app.setGlobalPrefix('api');
// GET /         →  GET /api
// GET /version  →  GET /api/version

Activer CORS

Par sécurité, un navigateur bloque les requêtes d'une page vers un autre domaine ou port que le sien. Une application Angular servie sur http://localhost:4200 ne peut donc pas appeler l'API sur http://localhost:3000 sans autorisation. C'est le rôle de CORS (Cross-Origin Resource Sharing) :

app.enableCors({
  origin: ['http://localhost:4200'],          // front-ends autorisés
  methods: ['GET', 'POST', 'PATCH', 'PUT', 'DELETE'],
});

Le port et le message de démarrage

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

const port = process.env.PORT ?? 3000;
await app.listen(port);
Logger.log(`API démarrée sur ${await app.getUrl()}/api`, 'Bootstrap');

Le Logger de NestJS affiche des messages formatés et colorés, avec la date et un contexte ([Bootstrap]), comme les messages du framework.

L'arrêt propre

app.enableShutdownHooks() permet à l'application de fermer proprement ses ressources (connexions à la base de données, tâches en cours) quand le serveur reçoit un signal d'arrêt, par exemple lors d'un redéploiement.

Un main.ts complet

import { Logger } from '@nestjs/common';
import { NestFactory } from '@nestjs/core';
import { AppModule } from './app.module';

async function bootstrap() {
  // 1. Création de l'application à partir du module racine
  const app = await NestFactory.create(AppModule);

  // 2. Configuration globale
  app.setGlobalPrefix('api');
  app.enableCors({ origin: ['http://localhost:4200'] });
  app.enableShutdownHooks();

  // 3. Démarrage du serveur
  const port = process.env.PORT ?? 3000;
  await app.listen(port);
  Logger.log(`API démarrée sur http://localhost:${port}/api`, 'Bootstrap');
}

bootstrap();

Dans les prochains chapitres, main.ts accueillera d'autres réglages globaux : la validation des données (useGlobalPipes, chapitre 08), les filtres d'exception (chapitre 09), la documentation Swagger (chapitre 14) et la sécurité (chapitre 19).

Activités

fetch('http://localhost:3000/api').then(r => r.text()).then(console.log)