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 opcjeloggeriforceConsoletak samo jakNestFactory.logger: truezostawia 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 aktualizacjifind-my-waydo 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 --remotepozwala 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
ExitWorktreekasował 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
Transitionignoruje przeterminowane wywołania przy ponownie użytym elemencie, a zmienne CSS trafiają przy renderowaniu na serwerze także do pętli, fragmentów,KeepAliveiTeleport. Ź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=1i 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
- NestJS v12.6.0 release notes, NestJS, 2026-11-20
- Codex rust-v0.171.0, OpenAI, 2026-11-20
- Claude Code v2.1.330, Anthropic, 2026-11-20
- Vue v3.5.46, Vue.js, 2026-11-20
- Vercel Functions now support request bodies up to 20MiB, Vercel, 2026-11-20
- FFmpeg 9.1 "Gauss", FFmpeg, 2026-11-20
Artykuł przygotowany z pomocą AI na podstawie źródeł pierwotnych i sprawdzony przez redakcję CodeWorlds.