Node.js v25: ключевые изменения и рекомендации для миграции

kirilljsx

Node.js v25 выпущен как текущая мажорная версия (Current) с обновлениями движка V8, криптографии, инструментов диагностики и рядом изменений поведения. Ниже — основные новшества и важные моменты, на которые стоит обратить внимание при обновлении проектов.

Общая информация

Статус ветки: v25 — текущий релизный канал (Current). Для продакшена по-прежнему рекомендуются LTS-ветки, но экосистеме предоставляется окно для адаптации под v25.
Доступные артефакты: Пакеты для всех платформ (tarball, MSI, PKG и др.) доступны в каталоге релиза v25.0.0, включая артефакты для CI.
Документация: Обновлена под API v25, включая CLI-флаги и стандартные модули. Добавлены и улучшены экспериментальные опции инспекции сети и CLI-инструменты для тестирования.

Диагностика и DevTools

Сетевая инспекция:
Флаг --experimental-network-inspection позволяет отслеживать сетевые вызовы в DevTools, включая сценарии на HTTP/2. Это упрощает отладку взаимодействий между микросервисами.
Инспекция HTTP/2:
В Chrome DevTools теперь доступна детальная информация о клиентских потоках, метриках и событиях HTTP/2 при запуске с инспектором — полезно для анализа производительности и выявления проблем на уровне протокола.

Криптография и Web Crypto

Новые алгоритмы:
В интерфейсы Web Crypto добавлены KMAC и Argon2, что позволяет использовать современные криптографические примитивы без внешних нативных зависимостей.
Поддержка постквантовых схем:
Реализована поддержка ML-DSA, SLH-DSA и Ed448 в модулях node:crypto и Web Crypto — это помогает готовить системы к будущим требованиям безопасности.

️ CLI и платформа

Расширенные CLI-флаги:
Добавлено множество экспериментальных флагов для:
- инспекции,
- измерения тестового покрытия,
- QUIC,
- EventSource,
- WebSocket,
- разрешения import.meta и др.
  Предназначены для раннего доступа и сбора обратной связи.
Модульная среда выполнения:
Документация v25 объединяет актуальные возможности ESM/CJS, Node-API и управление снапшотами/развёртыванием через CLI — важно для сборки и упаковки приложений.

️ Совместимость и депрекации

Устаревшие API:
Раздел Deprecated APIs обновлён для v25. Рекомендуется проверить проекты на наличие предупреждений при запуске — некоторые интерфейсы могут быть удалены в будущих мажорных версиях.
Схема релизов:
Как обычно, через ~6 месяцев ветка v25 перейдёт в архив, а основная поддержка будет сосредоточена на чётных LTS-версиях. Учитывайте это при планировании миграций.

Что проверить при обновлении до v25

Изменения в поведении API:
Поведение некоторых структур (например, связанных с Promise, Date, сетевыми стеками и криптографией) могло измениться. Рекомендуется:
- запускать тесты с включёнными предупреждениями,
- использовать инспектор для выявления неожиданных эффектов.
Криптографическая совместимость:
При использовании новых алгоритмов (KMAC, Argon2, Ed448 и др.) проверьте совместимость с внешними системами, особенно в гетерогенных или legacy-окружениях.

Ну и конечно же все подробности на официальном сайте - https://nodejs.org/en/blog/release/v25.0.0