Actualités

NestJS 12.6 déduit le type d'application, Codex passe à GPT-6.2 : l'actu du 20 novembre

NestJS 12.6.0 déduit le type d'application de l'adaptateur, ajoute l'arrêt en douceur des WebSockets et modifie gRPC. Ce que cela change pour apprendre.

Rédaction CodeWorlds
NestJS 12.6 déduit le type d'application, Codex passe à GPT-6.2 : l'actu du 20 novembre
  • TypeScript 7
  • Fastify
Dans cet article5

L'équipe NestJS a publié la version 12.6.0 le 20 novembre. Le changement le plus pratique est modeste : NestFactory.create() déduit désormais le type d'application à partir de l'adaptateur, ce qui supprime un générique habituel dans main.ts. Elle ajoute aussi l'arrêt en douceur des WebSockets et quelques changements de comportement à lire avant la mise à jour.

Les nouveautés de NestJS 12.6.0

Jusqu'ici, utiliser Fastify avec une bonne autocomplétion demandait d'écrire dans main.ts : NestFactory.create<NestFastifyApplication>(AppModule, new FastifyAdapter()). D'après les notes de version de la 12.6.0, le paramètre de type n'est plus nécessaire. Un appel avec new FastifyAdapter() renvoie un NestFastifyApplication, et c'est pareil pour ExpressAdapter et NodeAdapter. L'ancienne écriture compile toujours. Un adaptateur maison déclare son type d'application comme quatrième argument de type de AbstractHttpAdapter (PR #18623).

La deuxième nouveauté concerne les WebSockets. WsAdapter accepte maintenant les options gracefulShutdown (désactivée par défaut) et gracePeriod (10 000 ms par défaut). Une fois activées, l'application qui s'arrête refuse les nouvelles connexions, ignore les nouveaux messages, attend au plus gracePeriod que les handlers en cours se terminent, puis ferme chaque socket avec le code 1001. Lors d'un déploiement, le client reçoit ainsi un signal clair au lieu d'une connexion coupée net (PR #18589).

Le serveur gRPC reçoit une limite similaire, et c'est là que vous risquez une surprise. Avant, avec gracefulShutdown, il attendait les appels en cours sans limite. Depuis la 12.6.0, les appels qui ne se terminent pas dans le délai gracePeriod sont annulés. Si vous avez de longs flux, augmentez ce délai (PR #18566).

Les changements de comportement à vérifier

  • Un décorateur de paramètre personnalisé qui transmet l'objet réponse au handler se comporte désormais comme @Res() : l'objet arrive tel quel dans la méthode et aucun pipe ne s'applique. Sur Fastify, un tel handler ne s'exécutait même pas.
  • Dans les tests, createNestApplication() traite les options logger et forceConsole comme NestFactory. logger: true garde les logs actifs, alors qu'avant il les coupait.
  • Le routeur Fastify répond par une erreur 400 (FST_ERR_BAD_URL) quand le chemin d'une requête ne commence pas par /, suite à la mise à jour de find-my-way en 9.10.2.
  • Les clients de microservices (Kafka, MQTT, Redis, RabbitMQ) font échouer les requêtes en attente avec « Connection closed » quand la connexion se ferme, au lieu de les laisser sans réponse.

La liste des dépendances inclut aussi ws 8.23.0 et light-my-request 6.8.1. En plus des nouveautés, la version apporte 30 corrections de bugs dans common, core, microservices, testing et les adaptateurs HTTP, signées par 20 contributeurs. À mon avis, la mise à jour vaut le coup dès maintenant, à condition de lire d'abord les changements de comportement, surtout avec gRPC ou des tests de logs.

Ce que cela change si vous apprenez à coder

Si vous découvrez NestJS, retenez une chose de cette version : le framework exploite de mieux en mieux TypeScript pour vous éviter d'écrire des types à la main. Déduire un type d'un argument, c'est le mécanisme de toute fonction générique ordinaire. Mieux vaut le comprendre avant d'écrire vos propres décorateurs et adaptateurs. Les bases sont dans la documentation TypeScript et dans la collection consacrée à TypeScript.

L'arrêt en douceur semble avancé, mais l'idée mérite d'être comprise dès maintenant. Toute application déployée sera redémarrée un jour, et l'utilisateur ne doit rien perdre à ce moment-là. Quand vous arriverez aux WebSockets, regardez ce que fait votre application à la fermeture.

Contrôleurs, services, modules et WebSockets : on les voit pas à pas dans la formation NestJS. Vous hésitez entre Express et Fastify ? Voyez la collection consacrée à Fastify. Pour débuter, Express suffit : l'écart de performances ne compte qu'avec beaucoup de trafic.

En bref

  • Codex 0.171.0 avec les modèles GPT-6.2. La nouvelle version de l'outil d'OpenAI ajoute GPT-6.2 Sol et Astra au catalogue de modèles, avec Sol comme choix par défaut. La vue workspace du terminal est maintenant activée d'office, avec l'aperçu des documents, des images et des échanges des sous-agents, et codex exec --remote lance une session sur un serveur existant. Source
  • Claude Code 2.1.330 corrige des problèmes de stabilité. Elle supprime un blocage de plusieurs minutes après la compaction d'une très longue conversation, et un bug où ExitWorktree supprimait un worktree utilisé par une autre session. Les réglages ne se perdent plus quand plusieurs processus les enregistrent en même temps. Source
  • Vue 3.5.46 corrige les transitions et le SSR. Uniquement des corrections : le composant Transition ignore les callbacks périmés sur un élément réutilisé, et les variables CSS atteignent désormais les boucles, les fragments, KeepAlive et Teleport lors du rendu serveur. Source
  • Vercel Functions acceptent des requêtes jusqu'à 20 Mio. La limite du corps de requête passe de 4,5 Mo à 20 Mio, en bêta publique. Il faut VERCEL_SUPPORT_LARGE_REQUEST_BODY=1 et 4 Go de mémoire ; le runtime Edge garde l'ancienne limite. Source
  • FFmpeg 9.1 « Gauss ». La nouvelle version stable de la bibliothèque audio et vidéo est sortie le 20 novembre ; la branche 9.1 a été créée le 24 octobre. Source

Questions fréquentes

Faut-il modifier main.ts après la mise à jour vers NestJS 12.6 ?

Non. L'écriture avec un type explicite, par exemple NestFactory.create<NestFastifyApplication>(...), fonctionne toujours. Vous pouvez la retirer, mais rien ne vous y oblige.

À quoi sert gracefulShutdown dans WsAdapter ?

À l'arrêt de l'application, le serveur refuse les nouvelles connexions et les nouveaux messages, attend au plus gracePeriod (10 secondes par défaut) que les handlers en cours se terminent, puis ferme les sockets avec le code 1001. L'option est désactivée par défaut.

NestJS 12.6 peut-il casser un projet existant ?

Oui, avec un serveur gRPC et de longs flux, car les appels sont désormais annulés après gracePeriod. Vérifiez aussi les tests qui passent logger: true et les décorateurs personnalisés qui renvoient l'objet réponse.

Sources


Article préparé avec l'aide de l'IA à partir de sources primaires et relu par la rédaction de CodeWorlds.