Nowości

NestJS 12.6 wnioskuje typ aplikacji, a Codex dostaje GPT-6.2: co się działo 20 listopada

NestJS 12.6.0 wnioskuje typ aplikacji z adaptera, dodaje łagodne zamykanie WebSocketów i zmienia gRPC. Co to znaczy dla osób, które uczą się NestJS.

Redakcja CodeWorlds
NestJS 12.6 wnioskuje typ aplikacji, a Codex dostaje GPT-6.2: co się działo 20 listopada
  • TypeScript 7
  • Fastify
W tym artykule5

Zespół NestJS wydał 20 listopada wersję 12.6.0. Najwygodniejsza zmiana jest drobna: NestFactory.create() sam odgaduje typ aplikacji z adaptera, więc znika jeden z typowych generyków w main.ts. Do tego dochodzi łagodne zamykanie serwera WebSocket i kilka zmian zachowania, które warto znać przed aktualizacją.

Co nowego w NestJS 12.6.0

Do tej pory, kto chciał używać Fastify zamiast Expressa i mieć poprawne podpowiedzi w edytorze, pisał w main.ts mniej więcej tak: NestFactory.create<NestFastifyApplication>(AppModule, new FastifyAdapter()). Według notatek do wydania 12.6.0 parametr typu nie jest już potrzebny. Wywołanie z new FastifyAdapter() zwraca NestFastifyApplication, a to samo działa dla ExpressAdapter i NodeAdapter. Stary zapis z jawnym typem nadal się kompiluje, więc nic nie trzeba poprawiać. Autor własnego adaptera podaje typ aplikacji jako czwarty argument typu klasy AbstractHttpAdapter (PR #18623).

Druga nowość dotyczy WebSocketów. WsAdapter przyjmuje teraz opcje gracefulShutdown (domyślnie wyłączona) i gracePeriod (domyślnie 10 000 ms). Po ich włączeniu zamykana aplikacja przestaje przyjmować połączenia, ignoruje nowe wiadomości, czeka na skończenie bieżących handlerów najwyżej przez gracePeriod i zamyka każde gniazdo kodem 1001. Przy wdrożeniach to duża różnica: klient dostaje uczciwy sygnał „serwer odchodzi” zamiast urwanego połączenia (PR #18589).

Podobny limit dostał serwer gRPC i tu jest pierwsza zmiana, która może kogoś zaskoczyć. Wcześniej przy gracefulShutdown serwer czekał na trwające wywołania bez końca. Od 12.6.0 wywołania, które nie skończą się w gracePeriod, są anulowane. Jeśli masz długie strumienie, podnieś ten limit (PR #18566).

Zmiany zachowania, które warto sprawdzić

  • Własny dekorator parametru, który przekazuje do handlera obiekt odpowiedzi, działa teraz jak @Res(): obiekt trafia do metody bez zmian i nie przechodzi przez pipe'y. Na Fastify taki handler wcześniej w ogóle się nie uruchamiał.
  • W testach createNestApplication() traktuje opcje logger i forceConsole tak samo jak NestFactory. logger: true zostawia logi włączone, choć wcześniej je wyłączało.
  • Router Fastify odpowiada kodem 400 (FST_ERR_BAD_URL) na żądanie, którego ścieżka nie zaczyna się od /. To skutek aktualizacji find-my-way do 9.10.2.
  • Klienci mikroserwisów (Kafka, MQTT, Redis, RabbitMQ) kończą oczekujące żądania błędem „Connection closed”, zamiast zostawiać je bez odpowiedzi, gdy połączenie się zamknie.

Na liście zależności są też ws 8.23.0 i light-my-request 6.8.1. Poza nowościami wydanie przynosi 30 poprawek błędów w pakietach common, core, microservices, testing i adapterach HTTP, od 20 autorów. Moim zdaniem to aktualizacja, którą warto zrobić od razu, ale z przejrzeniem sekcji o zmianach zachowania, szczególnie jeśli korzystasz z gRPC albo testujesz logowanie.

Co to znaczy, jeśli uczysz się programowania

Jeśli dopiero poznajesz NestJS, z tego wydania zapamiętaj jedną rzecz: framework coraz lepiej korzysta z TypeScriptu, żeby oszczędzić ci ręcznego wpisywania typów. Wnioskowanie typu z argumentu to ten sam mechanizm, którego używasz na co dzień w zwykłych funkcjach generycznych. Dobrze go rozumieć, zanim zaczniesz pisać własne dekoratory i adaptery. Podstawy znajdziesz w dokumentacji TypeScript i w kolekcji o TypeScript.

Łagodne zamykanie serwera brzmi jak temat dla zaawansowanych, ale warto złapać samą ideę już teraz. Każda aplikacja, którą wdrożysz, będzie kiedyś restartowana, a użytkownik nie powinien wtedy tracić danych. Gdy dojdziesz do WebSocketów, sprawdź, co robi twoja aplikacja przy zamknięciu.

Kontrolery, serwisy, moduły i WebSockety przerabiamy krok po kroku w kursie NestJS. Jeśli zastanawiasz się, czy przejść z Expressa na Fastify, zajrzyj do kolekcji o Fastify. Na początek wystarczy jednak domyślny Express: różnice w wydajności zaczynają mieć znaczenie dopiero przy dużym ruchu.

Krótko: inne wiadomości dnia

  • Codex 0.171.0 z modelami GPT-6.2. Nowa wersja narzędzia OpenAI dodaje do katalogu modele GPT-6.2 Sol i Astra, z Sol jako domyślnym wyborem. Widok workspace w terminalu jest teraz włączony od razu, z podglądem dokumentów, obrazów i przebiegu subagentów, a codex exec --remote pozwala uruchomić sesję na istniejącym serwerze. Źródło
  • Claude Code 2.1.330 z poprawkami stabilności. Wydanie usuwa zawieszanie się na kilka minut po skompaktowaniu bardzo długiej rozmowy i błąd, przez który ExitWorktree kasował worktree używany przez inną sesję. Ustawienia nie giną już, gdy zapisuje je kilka procesów naraz. Źródło
  • Vue 3.5.46 z poprawkami przejść i SSR. Same poprawki błędów: komponent Transition ignoruje przeterminowane wywołania przy ponownie użytym elemencie, a zmienne CSS trafiają przy renderowaniu na serwerze także do pętli, fragmentów, KeepAlive i Teleport. Źródło
  • Vercel Functions przyjmują żądania do 20 MiB. Limit treści żądania rośnie z 4,5 MB do 20 MiB w publicznej becie. Trzeba ustawić zmienną VERCEL_SUPPORT_LARGE_REQUEST_BODY=1 i pamięć funkcji 4 GB, a runtime Edge zostaje przy starym limicie. Źródło
  • FFmpeg 9.1 „Gauss”. Nowe stabilne wydanie biblioteki do audio i wideo ukazało się 20 listopada; gałąź 9.1 została wydzielona 24 października. Źródło

Najczęstsze pytania

Czy po aktualizacji do NestJS 12.6 muszę zmienić main.ts?

Nie. Zapis z jawnym typem, na przykład NestFactory.create<NestFastifyApplication>(...), nadal działa. Możesz go usunąć, bo typ zostanie wywnioskowany z adaptera, ale nie musisz.

Co robi gracefulShutdown w WsAdapter?

Przy zamykaniu aplikacji serwer przestaje przyjmować nowe połączenia i wiadomości, czeka na bieżące handlery najwyżej przez gracePeriod (domyślnie 10 sekund) i zamyka gniazda kodem 1001. Opcja jest domyślnie wyłączona.

Czy NestJS 12.6 może coś zepsuć w istniejącym projekcie?

Może, jeśli używasz serwera gRPC z długimi strumieniami, bo po gracePeriod wywołania są teraz anulowane. Warto też sprawdzić testy, które przekazują logger: true, i własne dekoratory zwracające obiekt odpowiedzi.

Źródła


Artykuł przygotowany z pomocą AI na podstawie źródeł pierwotnych i sprawdzony przez redakcję CodeWorlds.