Релиз NestJS 12.4.0: локальные переменные вьюх, фиксы MQTT и валидацияЗаметка · дайджест за 7 ноября
Модульный конструктор в стиле Баухаус с эмблемой NestJS, иллюстрирующий обновление v12.4.0, глобальные locals и исправления микросервисов.
Заметка2 раздела≈ 3 мин

Релиз NestJS 12.4.0: локальные переменные вьюх, фиксы MQTT и валидация

В серверной экосистеме TypeScript фреймворк Камиля Мысливца (Kamil Mysliwiec) давно закрепился как стандарт де-факто для построения масштабируемых бэкендов. Но даже в зрелых проектах регулярные минорные обновления приносят долгожданные точечные улучшения, закрывающие шероховатости в продакшене. Релиз NestJS v12.4.0, вышедший 6 ноября 2026 года, как раз из таких: он не ломает обратную совместимость, но исправляет сразу несколько неприятных багов в микросервисах и существенно упрощает работу с серверными представлениями.

В контексте продолжающейся эволюции Node.js этот выпуск гармонично подтягивает работу адаптеров под актуальные стандарты платформы.

Давай посмотрим, что именно изменилось под капотом и как эти новшества применить в кодовой базе.

Серверный рендеринг и глобальные locals

Если ты разрабатываешь гибридные приложения, где часть страниц рендерится на сервере через пакет @nestjs/platform-node или Express-адаптер, тебе наверняка знакомо неудобство с пробросом глобальных данных в шаблоны. Передавать номер версии приложения, имя сервиса или базовые метатеги приходилось либо через кастомные мидлвары, либо вручную вставлять в объект каждого контроллера.

В PR #18396 разработчики добавили метод setLocal(), позволяющий декларативно зарегистрировать переменные уровня всего приложения при инициализации:

import { NestFactory } from '@nestjs/core';
import { NestExpressApplication } from '@nestjs/platform-express';
import { AppModule } from './app.module';
import { join } from 'path';

async function bootstrap() {
  const app = await NestFactory.create<NestExpressApplication>(AppModule);

  app.setBaseViewsDir(join(__dirname, '..', 'views'));
  app.setViewEngine('eta');

  // Глобальные переменные теперь доступны во всех вьюхах по умолчанию
  app.setLocal('appName', 'Портал разработчика');
  app.setLocal('appVersion', '12.4.0');
  app.setLocal('releaseYear', new Date().getFullYear());

  await app.listen(3000);
}
bootstrap();

Вместе с этим в PR #18395 в Node-адаптер добавили официальную поддержку современных легковесных шаблонизаторов Eta, LiquidJS и art-template, а также исправили обработку путей с завершающими слешами (trailing slashes).

Стабильность MQTT и детальная валидация массивов

Второе ключевое направление релиза — микросервисы и обработка сетевых контрактов:

  1. Защита от бесконечного цикла в MQTT: В PR #18418 устранена коварная ошибка брокера сообщений. Ранее, если сервис подписывался на топики с масками (wildcards + или #), брокер мог ошибочно перехватывать собственные ответы сервера и отправлять их обратно в обработчик, вызывая лавинообразную петлю сообщений (infinite reply loop). Теперь серверные ответы строго изолированы от шаблонов подписки.
  2. Точная детализация в ParseArrayPipe: При пакетной валидации списков сущностей через ParseArrayPipe пайп раньше обрезал контекст вложенных ошибок валидации, затрудняя понимание того, какое конкретно поле в каком элементе массива не прошло проверку. В PR #18419 сохраняются все сгруппированные поля валидатора:
import { Controller, Post, Body, ParseArrayPipe, HttpStatus } from '@nestjs/common';
import { IsString, IsEmail, MinLength } from 'class-validator';

export class RegisterUserDto {
  @IsString()
  @MinLength(3)
  username: string;

  @IsEmail()
  email: string;
}

@Controller('users')
export class UsersBatchController {
  @Post('import')
  async importUsers(
    @Body(
      new ParseArrayPipe({
        items: RegisterUserDto,
        errorHttpStatusCode: HttpStatus.UNPROCESSABLE_ENTITY,
        whitelist: true,
        forbidNonWhitelisted: true,
      }),
    )
    users: RegisterUserDto[],
  ) {
    return { importedCount: users.length, status: 'ok' };
  }
}

Также в релизе устранили мутацию опций в ConsoleLogger (PR #18402), починили передачу потоковых опций вызова в gRPC (PR #18392) и обновили CORS-адаптер Fastify до версии 11.4.1. Обновление ставится стандартным npm update @nestjs/core @nestjs/common и не требует изменений существующей архитектуры.

Хочу подробный разборГолоса помогают выбрать, что разобрать подробно. За этот материал 0 голосов.
Источники · 2