Next.js 16.4: що змінилося і що може зламатися

Next.js 16.4.0 опублікували 7 жовтня 2026 року. За замовчуванням він робить продакшн-збірки Turbopack меншими, прибирає префікс unstable_ з API навігації та prefetch і видаляє кілька експериментальних функцій. Якщо ви використовуєте App Router, прочитайте список видалень, перш ніж піднімати версію.

Усі факти нижче взято зі сторінки релізу v16.4.0 на GitHub. Це підсумок ключових пунктів, а не повний журнал змін.

Що нового в Next.js 16.4?

• Вихідні дані Turbopack. Перейменування експортів (name mangling) увімкнено за замовчуванням для продакшн-збірок, імена класів CSS-модулів стали коротшими, а продакшн ділить код на чанки за сегментами layout. Серверну мініфікацію можна ввімкнути через experimental.serverMinification.
• Аналізатор бандла. Тепер він записує історичні знімки під час кожного запуску, а також отримав порівняння та короткий підсумок за маршрутами. Тож питання «чи зробив цей PR бандл більшим?» стає відповідним.
• Prefetching. ensureStatic стабілізовано в Partial Prefetching, а navigation() і prefetch() втратили префікс unstable_.
• Нові проєкти. create-next-app тепер вмикає Cache Components за замовчуванням.
• Оновлення. Є опція next upgrade --ai для оновлень із підтримкою ШІ.
• Зображення. Оптимізацію AVIF знову ввімкнено, а з'явилася експериментальна опція imgOptMozjpeg.
• Досвід розробки. Динамічні імпорти в режимі розробки компілюються на клієнті з відкладенням.

Що зламається під час оновлення?

Це частина, важлива для працюючого продукту.

• experimental.appNewScrollHandler та unstable_eager прибрано.
• Старі імпорти navigation() і prefetch() із unstable_ перестають працювати. Перейменуйте їх.
• Строге співставлення маршрутів тепер за замовчуванням, інтерцептні маршрути мають використовувати канонічні маршрути, а сторінки App, які не відповідають жодному маршруту, викликають помилку.
• Шляхи старого часткового попереднього рендерингу (legacy PPR) прибрано.
• Підтримку React 18 для Pages Router позначено як застарілу.
• Нативні прив'язки перейшли з napi-rs v2 на v3, що може вплинути на тих, хто має власні нативні прив'язки.

Як оновитися безпечно?

1. Створіть гілку і піднімайте next до 16.4.0.
2. Пошукайте в коді unstable_navigation, unstable_prefetch, appNewScrollHandler і unstable_eager.
3. Запустіть продакшн-збірку і пройдіться маршрутами, які використовують інтерцепцію або динамічні параметри. Саме тут ми очікуємо сюрпризів через строге співставлення.
4. Порівняйте розмір бандла до і після, використовуючи нові знімки аналізатора.
5. Лише потім вмикайте експерименти, які мають вмикатися вручну.

Чи варто оновлюватися одразу?

Якщо ви на 16.x і не користуєтесь видаленими експериментами, оновлення в окремій гілці коштує недорого. Якщо ви використовуєте Pages Router на React 18, у вас є час, але план переходу варто скласти. Слідкуйте й за інструментами навколо вашого стеку. Подивіться розробницькі інструменти та фреймворки на Woodander, щоб побачити, з чим працюють команди.

FAQ

Коли вийшов Next.js 16.4.0?

На сторінці релізу вказано 7 жовтня 2026 року.

Чи прибирає 16.4 Pages Router?

Ні. Він позначає як застарілу підтримку React 18 для Pages Router, а це не те саме, що прибрати сам роутер.

Який найбезпечніший спосіб спробувати?

Використовуйте окрему гілку, запустіть продакшн-збірку і протестуйте інтерцептні та динамічні маршрути до злиття.