28 жовтня Node.js 26 стає LTS. Розбираю, кому оновлюватись зараз, що нового (Temporal, upsert для Map), що видалили, як знайти проблеми скриптом до оновлення і як перевести продакшен з Node 22/24 без сюрпризів.
- Опубліковано
- Читання
- 12 хв
- Автор
- Yaroslav Tsarenko

28 жовтня 2026 року Node.js 26 отримує статус LTS. Для більшості команд це сигнал, що настав час планувати оновлення. Тут три різні питання, які часто плутають: який патч безпеки поставити просто зараз, коли переходити на 26-ту гілку і що в проєкті при цьому може зламатися.
Розберу все з кодом: дати підтримки, нові можливості, які варто використовувати, видалені API, скрипт, що за секунду знаходить ризиковані місця, матрицю CI і покроковий план переходу. Приклади на TypeScript, перевірені на TypeScript 6.0 з @types/node 26.
Що саме стається 28 жовтня
Node.js 26.0.0 вийшов 5 травня 2026 року і пів року мав статус Current, коли API ще можуть змінюватись. 28 жовтня він переходить в Active LTS. Відтепер у ньому виправлятимуть помилки й вразливості, але без ламаючих змін. Офіційний розклад лежить у репозиторії nodejs/Release:
| Гілка | Статус на кінець жовтня 2026 | Maintenance з | Кінець підтримки |
|---|---|---|---|
| Node.js 20 | не підтримується | — | 30.04.2026 |
| Node.js 22 | Maintenance LTS | 21.10.2025 | 30.04.2027 |
| Node.js 24 | Maintenance LTS | 20.10.2026 | 30.04.2028 |
| Node.js 26 | Active LTS з 28.10.2026 | 20.10.2027 | 30.04.2029 |
| Node.js 27 | alpha з 28.10.2026 | — | 30.04.2030 |
Ще одна новина того ж дня: Node.js 26 — остання версія за старою схемою «парні стають LTS, непарні — ні». З Node.js 27 проєкт переходить на річний цикл: одна велика версія на рік у квітні, LTS у жовтні, і кожна версія стає LTS. Непарних «експериментальних» релізів більше не буде, замість них з’являється шестимісячна alpha-фаза для авторів бібліотек і CI.
Для бізнесу це гарна новина: оновлення стають передбачуваними, раз на рік за тим самим календарем.
Спершу безпека: патч від 21 жовтня
Перш ніж думати про 26-ту версію, поставте патч на ту гілку, яка у вас зараз. 21 жовтня 2026 року Node.js випустив безпекові оновлення для всіх підтримуваних гілок: 26.12.1, 24.22.1 і 22.23.4. Вони закривають 10 вразливостей, з них чотири високого рівня:
| CVE | Що не так | Кого стосується |
|---|---|---|
| CVE-2026-111497 | запис за межі буфера в декодері Brotli (node:zlib): падіння, витік пам’яті або виконання коду |
22, 24, 26 |
| CVE-2026-105482 | dns.resolve*() обрізає ім’я на NUL-байті |
22, 24, 26 |
| CVE-2026-105483 | перевірка сертифіката не розпізнає IP, записаний «широкими» цифрами | 24, 26 |
| CVE-2026-106069 | IPv4 з нулем попереду (0127.0.0.1) різні частини системи читають по-різному |
22, 24, 26 |
Найнеприємніша — Brotli: стиснуті відповіді й запити проходять через zlib у дуже багатьох застосунках, навіть якщо ви про це не думаєте. Перевірка займає секунду:
node -p "process.version"v24.22.1Якщо версія нижча за 22.23.4, 24.22.1 чи 26.12.1 у своїй гілці, оновіться сьогодні. Не забудьте Docker-образи: тег node:24 без цифр патча підтягне нову версію лише після перезбирання образу. На керованих платформах патч зазвичай розкатують без вас, але process.version у логах варто перевірити й там.
Кому оновлюватись на 26 і коли
Головне правило: версію обирає продакшен, а не ноутбук розробника. Node.js 26 на локальній машині нічого не дає, якщо хостинг його ще не підтримує.
| Ваша ситуація | Що робити |
|---|---|
| Ще на Node.js 20 чи старішому | Терміново: гілка без виправлень безпеки з 30 квітня 2026. Переходьте одразу на 24 або 26 |
| Node.js 22 | Запланувати перехід до квітня 2027. Якщо хостинг дозволяє — одразу на 26, щоб не оновлюватись двічі |
| Node.js 24 | Поставити 24.22.1 і спокійно планувати 26 на 2027 рік. Запас до квітня 2028-го |
| Новий проєкт | 26, якщо хостинг його підтримує. Якщо ні — 24 з планом переходу |
| Serverless (Vercel, Lambda) | Чекати офіційної підтримки 26 провайдером, не обходити її власним рантаймом |
Окремо про Vercel, бо на ньому живе багато Next.js-проєктів. Станом на кінець жовтня документація для збірок і функцій називає 24.x (за замовчуванням) і 22.x, а Node.js 20 там знято з підтримки з 1 жовтня 2026-го. Node.js 26 офіційно доступний лише у Vercel Sandbox. Тому "engines": { "node": "26.x" } у package.json для Vercel-проєкту поки ставити не варто: дочекайтеся, поки 26.x з’явиться в налаштуваннях проєкту.
Що нового і чим варто користуватися
Повний список змін — у нотатках до 26.0.0. Для щоденної роботи важливі три речі.
Нове
- Temporal за замовчуваннямдати й часові зони без бібліотек
- Map.getOrInsertComputedupsert без if/has/set
- V8 14.6 і Undici 8Iterator.concat, новий fetch-клієнт
Видалено
- _stream_* модулівикористовуйте node:stream
- writeHeader()лише writeHead()
- --experimental-transform-typesenum і namespace без компіляції
Застаріло
- module.register()DEP0205, перейдіть на registerHooks()
- Частина crypto і stream APIDEP0201, DEP0203, DEP0204
Temporal замість Date
Найпомітніша зміна: Temporal API увімкнено за замовчуванням. Це новий стандарт JavaScript для дат і часу, який виправляє давні проблеми Date: змінюваність, відсутність часових зон і дивну арифметику з місяцями.
Ось типова помилка, яку Date робить непомітно. В Україні 25 жовтня 2026 року годинник переводять на зимовий час. Зустріч щодня о 10:00 — що буде, якщо додати до суботньої зустрічі «один день»?
const meeting = Temporal.ZonedDateTime.from("2026-10-24T10:00[Europe/Kyiv]");
console.log(meeting.add({ days: 1 }).toString());
console.log(meeting.add({ hours: 24 }).toString());
const legacy = new Date("2026-10-24T10:00:00+03:00");
legacy.setTime(legacy.getTime() + 24 * 60 * 60 * 1000);
console.log(legacy.toLocaleString("uk-UA", { timeZone: "Europe/Kyiv" }));2026-10-25T10:00:00+02:00[Europe/Kyiv]
2026-10-25T09:00:00+02:00[Europe/Kyiv]
25.10.2026, 09:00:00Temporal розрізняє «наступний день у календарі» (10:00, як і чекає людина) і «рівно 24 години потому» (09:00 після переведення годинника). Код на Date, що додає 24 * 60 * 60 * 1000, тихо зсуває нагадування, бронювання й розсилки на годину двічі на рік.
Ще два приклади, де Temporal поводиться передбачувано:
const trialEnds = Temporal.PlainDate.from("2026-01-31").add({ months: 1 });
console.log(trialEnds.toString());
const since = Temporal.PlainDate.from("2026-05-05").until("2026-10-28", { largestUnit: "months" });
console.log(since.toString(), since.months, since.days);2026-02-28
P5M23D 5 23Пробний період з 31 січня закінчується 28 лютого, а не «3 березня», як вийде з setMonth(). Різниця дат одразу приходить у місяцях і днях.
Типи: TypeScript 6.0 має вбудовані типи Temporal у lib: ["esnext"] або точковому esnext.temporal. Якщо частина сервісів ще працює на 22 чи 24, підключіть temporal-polyfill: API той самий, і після переходу поліфіл просто видаляється.
Upsert для Map: getOrInsert і getOrInsertComputed
V8 14.6 приносить методи, які прибирають класичний шаблон if (!map.has(k)) map.set(k, ...). Групування замовлень за клієнтом:
type Order = { tenant: string; total: number };
const orders: Order[] = [
{ tenant: "acme", total: 120 },
{ tenant: "globex", total: 80 },
{ tenant: "acme", total: 40 },
];
const byTenant = new Map<string, Order[]>();
for (const order of orders) {
byTenant.getOrInsertComputed(order.tenant, () => []).push(order);
}
console.log([...byTenant].map(([tenant, list]) => `${tenant}: ${list.length}`));[ 'acme: 2', 'globex: 1' ]getOrInsertComputed викликає фабрику лише тоді, коли ключа ще немає. Це зручно для кешів у пам’яті, лічильників і «ледачої» ініціалізації клієнтів для кожного тенанта. Типи є в esnext lib TypeScript 6.0.
Iterator.concat і Undici 8
Iterator.concat() склеює кілька ітераторів без проміжних масивів: корисно, коли ви читаєте дані сторінками з кількох джерел. Вбудований fetch тепер працює на Undici 8. Якщо ви налаштовували fetch через власний Agent чи dispatcher, прогоніть інтеграційні тести на зовнішні API.
Що видалили і що зламається
Тут небагато пунктів, але кожен здатен зупинити деплой.
Видалено повністю:
- модулі
_stream_wrap,_stream_readable,_stream_writable,_stream_duplex,_stream_transform,_stream_passthrough. Сучасний код їх не імпортує, але старі залежності інколи ще роблятьrequire("_stream_readable"); http.Server.prototype.writeHeader()— замість ньогоwriteHead();- прапорець
--experimental-transform-types. Якщо вpackage.jsonє скрипт із ним,nodeпросто не запуститься.
Нативні модулі. NODE_MODULE_VERSION піднято до 147. Модулі, зібрані на Node-API (sharp, більшість сучасних), працюють без змін, бо цей інтерфейс стабільний між версіями. Старі аддони, зібрані під конкретну версію V8, треба перезібрати (npm rebuild) або оновити. Список таких модулів друкує скрипт-перевірка нижче.
Застаріло з попередженням у рантаймі:
module.register()(DEP0205). Заміна — синхроннийmodule.registerHooks(), нижче є приклад;- кілька API у
crypto(DEP0203, DEP0204) іstream(DEP0201). Поки що це лише попередження, але CI з--throw-deprecationперетворить їх на помилки, і ви знайдете їх заздалегідь.
localStorage на сервері. У Node.js 26 без прапорця --localstorage-file глобальний localStorage дорівнює undefined. Код, що на сервері розраховує на localStorage, треба перевірити. Код у клієнтських компонентах це не зачіпає.
Скрипт-перевірка: знайдіть проблеми до оновлення
Замість того щоб читати changelog і шукати руками, я написав невеликий скрипт. Він друкує поточну версію і поле engines, знаходить нативні модулі в node_modules і шукає у вашому коді шаблони, які ламаються в Node.js 26. Скрипт написаний на TypeScript і запускається напряму через node, без збирання (про це в наступному розділі).
import { readdir, readFile } from "node:fs/promises";
import path from "node:path";
const root = process.argv[2] ?? process.cwd();
const risky: [RegExp, string][] = [
[/require\(["']_stream_\w+["']\)|from ["']_stream_\w+["']/, "legacy _stream_* modules were removed"],
[/\.writeHeader\(/, "writeHeader() was removed, use writeHead()"],
[/\bregister\(\s*["'][^"']+["']\s*,\s*import\.meta\.url/, "module.register() is runtime-deprecated (DEP0205)"],
[/--experimental-transform-types/, "the flag was removed in Node 26"],
[/\blocalStorage\b/, "localStorage is undefined without --localstorage-file"],
];
async function* walk(dir: string, skip: Set<string>): AsyncGenerator<string> {
for (const entry of await readdir(dir, { withFileTypes: true })) {
if (skip.has(entry.name)) continue;
const full = path.join(dir, entry.name);
if (entry.isDirectory()) yield* walk(full, skip);
else yield full;
}
}
const pkg = JSON.parse(await readFile(path.join(root, "package.json"), "utf8"));
console.log(`node ${process.version}, engines: ${pkg.engines?.node ?? "not set"}`);
const native = new Set<string>();
for await (const file of walk(path.join(root, "node_modules"), new Set([".cache"]))) {
if (file.endsWith(".node") || file.endsWith("binding.gyp")) {
const rel = path.relative(path.join(root, "node_modules"), file).split(path.sep);
native.add(rel[0].startsWith("@") ? `${rel[0]}/${rel[1]}` : rel[0]);
}
}
console.log(`native addons (Node-API ones keep working, others need a rebuild): ${native.size ? [...native].join(", ") : "none"}`);
const code = /\.(m|c)?(j|t)sx?$|package\.json$/;
const skip = new Set(["node_modules", ".next", ".git", "dist", "build"]);
let hits = 0;
for await (const file of walk(root, skip)) {
if (!code.test(file)) continue;
const lines = (await readFile(file, "utf8")).split("\n");
lines.forEach((line, i) => {
for (const [re, why] of risky) {
if (re.test(line)) {
hits++;
console.log(`${path.relative(root, file)}:${i + 1} ${why}`);
}
}
});
}
console.log(hits ? `${hits} place(s) to review` : "no known Node 26 breaking patterns found");Збережіть як node26-check.ts поруч із package.json з "type": "module" і запустіть node node26-check.ts ./my-service. Ось реальний вивід на тестовому сервісі зі старим кодом (запуск на Node 25.7):
node v25.7.0, engines: >=20
native addons (Node-API ones keep working, others need a rebuild): none
package.json:1 the flag was removed in Node 26
src/server.ts:2 legacy _stream_* modules were removed
src/server.ts:3 writeHeader() was removed, use writeHead()
3 place(s) to reviewКілька чесних застережень. Це пошук за шаблонами, а не аналіз коду, тому будуть хибні спрацювання: на цьому сайті скрипт знайшов localStorage у п’яти клієнтських компонентах, які на сервері не виконуються. І навпаки, він не бачить проблем усередині залежностей — для цього є CI з --throw-deprecation. Зате за секунду ви отримуєте список місць, з яких варто почати.
TypeScript без збирання: що змінилось
Node.js уміє запускати .ts-файли напряму: він просто прибирає типи й виконує JavaScript, що лишився. У документації ця можливість має статус Stable з версій 25.2.0 і 24.12.0. Типи при цьому не перевіряються, тому tsc --noEmit у CI лишається обов’язковим.
У Node.js 26 видалили прапорець --experimental-transform-types, який дозволяв конструкції TypeScript, що генерують код: enum, namespace з кодом, parameter properties у конструкторах. Тепер правило просте: якщо код запускається через node напряму, у ньому має бути лише синтаксис, який можна стерти. Увімкніть у tsconfig.json опцію "erasableSyntaxOnly": true, і компілятор підсвітить усе, що не пройде.
Типова заміна enum:
export const OrderStatus = { Pending: "pending", Paid: "paid", Refunded: "refunded" } as const;
export type OrderStatus = (typeof OrderStatus)[keyof typeof OrderStatus];
const status: OrderStatus = OrderStatus.Paid;
console.log(status);paidЯкщо ви переходите й на TypeScript 6.0, зверніть увагу на одну зміну за замовчуванням: types тепер []. Без явного "types": ["node"] у tsconfig.json зникнуть типи process, Buffer і решти Node API. У TypeScript 7 з нативним компілятором це правило лишилось, а що ще там ламається (rootDir, ESLint, next build), я розібрав у статті про міграцію на TypeScript 7.
Завантажувачі модулів: з register() на registerHooks()
Якщо у вас є власний loader (аліаси шляхів, моки в тестах, інструментування), module.register() тепер друкує попередження DEP0205. Документація радить синхронні хуки module.registerHooks(): вони працюють у тому ж потоці, простіші й мають deregister(). Приклад аліасу @/ на папку src/:
import { registerHooks } from "node:module";
const srcRoot = new URL("./src/", import.meta.url);
registerHooks({
resolve(specifier, context, nextResolve) {
if (specifier.startsWith("@/")) {
return nextResolve(new URL(specifier.slice(2), srcRoot).href, context);
}
return nextResolve(specifier, context);
},
});node --import ./hooks.ts main.tshello, Node 26Тут main.ts імпортує @/lib/hello.ts, і хук перетворює це на шлях до src/lib/hello.ts. registerHooks() доступний з Node 22.15, тож цей код працює однаково на 22, 24 і 26 — переписати loader можна ще до оновлення.
CI на двох версіях одночасно
Найдешевший спосіб оновитися без сюрпризів — кілька тижнів ганяти тести паралельно на поточній і новій версії. Мінімальна матриця для GitHub Actions:
name: ci
on: [push, pull_request]
jobs:
test:
runs-on: ubuntu-latest
strategy:
fail-fast: false
matrix:
node: [24, 26]
steps:
- uses: actions/checkout@v7
- uses: actions/setup-node@v7
with:
node-version: ${{ matrix.node }}
cache: npm
- run: npm ci
- run: npx tsc --noEmit
- run: npm test
env:
NODE_OPTIONS: --throw-deprecationfail-fast: false не дає падінню на 26 скасувати прогін на 24. Так ви бачите обидва результати. --throw-deprecation перетворює попередження про застарілі API на помилки, і ви ловите їх у тестах, а не в логах продакшену. npm ci на 26-й версії одразу покаже, чи збираються нативні модулі.
Для Docker достатньо змінити базовий образ, наприклад з node:24-bookworm-slim на node:26-bookworm-slim. Для продакшену краще фіксувати точну версію (node:26.12.1-bookworm-slim) і оновлювати її свідомо, а не з кожним перезбиранням.
Next.js-проєкти: оновіть і фреймворк
Для Next.js сама версія Node.js рідко стає проблемою: документація вимагає щонайменше Node.js 20.9, тож і 24, і 26 підходять. Важливіше те, що оновлювати варто в парі. 14 жовтня 2026 року Next.js випустив позапланове оновлення безпеки — версії 16.4.1 і 15.5.28. Воно закриває дві критичні вразливості з віддаленим виконанням коду: у функціях use cache, що повертають typed arrays, і в Image Optimization API при роботі з SVG. Третя, високого рівня, дозволяє покласти процес запитами до Server Actions.
Тому в чек-лист оновлення Node.js варто одразу додати рядок npm ls next і перевірку, що версія не нижча за виправлену у вашій гілці. Обидва оновлення проходять ту саму перевірку в CI і на staging, і окремий цикл тестування заради кожного не потрібен. Наступний шар із дедлайном — база: PostgreSQL 14 втрачає підтримку 12 листопада 2026 року, і цей перехід я розібрав у статті PostgreSQL 19: що нового і як оновитися.
Покроковий план переходу
Порядок важливіший за швидкість. Так це виглядає для типового продакшен-сервісу на Node.js чи Next.js:
- день 0Патч безпеки22.23.4 / 24.22.1 / 26.12.1 — сьогодні
- день 1Розвідкаскрипт-перевірка, нативні модулі, хостинг
- тиждень 1CI на двох версіяхматриця 24 + 26, --throw-deprecation
- тиждень 2StagingDocker-образ node:26, навантаження, логи
- тиждень 3Продакшенпоступовий реліз, план відкату
- Патч безпеки сьогодні. 22.23.4, 24.22.1 або 26.12.1 — у всіх середовищах, включно з воркерами, cron-задачами й Docker-образами.
- Розвідка. Скрипт вище,
npm lsдля нативних модулів, перевірка, чи підтримує ваш хостинг 26.x. - CI на 24 і 26. Виправити все, що впало, оновити залежності, які друкують попередження.
- Staging на 26. Той самий образ, що піде в продакшен. Прогнати реальні сценарії: оплати, вебхуки, фонові задачі, генерацію файлів. Порівняти пам’ять і час відповіді з поточною версією.
- Продакшен поступово. Спершу один інстанс чи частина трафіку, потім решта. План відкату — попередній образ, який можна повернути однією командою.
- Прибрати хвости. Оновити
engines,.nvmrc, документацію і, якщо використовували, видалитиtemporal-polyfill.
Найчастіше болить не сам Node.js, а фонові задачі й інтеграції, які рідко хтось запускає вручну. Я окремо писав про надійні фонові воркери на Node.js. Повтори, ідемпотентність і dead-letter черга роблять такі оновлення значно спокійнішими. Схожу роботу — черги, стрімінг PDF і пришвидшення PostgreSQL на Node.js — я робив для американської платформи керування замовленнями.
Чек-лист перед оновленням
| Перевірка | Як | Готово, якщо |
|---|---|---|
| Патч безпеки | node -p "process.version" у кожному середовищі |
≥ 22.23.4 / 24.22.1 / 26.12.1 |
| Хостинг | налаштування проєкту, документація провайдера | 26.x є у списку підтримуваних |
| Нативні модулі | скрипт, npm ci на 26 |
усе збирається або використовує Node-API |
| Видалені API | скрипт, пошук _stream_, writeHeader |
нуль збігів |
| Застарілі API | тести з --throw-deprecation |
тести зелені |
| TypeScript | erasableSyntaxOnly, "types": ["node"] |
tsc --noEmit без помилок |
| Next.js | npm ls next |
≥ 16.4.1 або ≥ 15.5.28 у своїй гілці |
| Дати | пошук 24 * 60 * 60 * 1000, setMonth( |
критичні місця переведені на Temporal або покриті тестами |
| Відкат | попередній образ або версія в налаштуваннях | відкат перевірено хоча б раз |
Що зробити цього тижня
Node.js 26 LTS — спокійне оновлення без великих змін в архітектурі. Ламаються переважно старі залежності й забуті прапорці. А Temporal і нові методи Map дають реальну користь щодня.
Мінімум на цей тиждень: поставити патч від 21 жовтня, запустити скрипт-перевірку і додати 26 у CI-матрицю. Сам перехід продакшену можна робити, коли тести зелені на обох версіях і ваш хостинг офіційно підтримує 26.x. Якщо ваш застосунок на Next.js, у мене є окрема стаття про App Router у продакшені. А якщо потрібна допомога з оновленням чи аудитом Node.js-бекенду — ось як я працюю з Next.js і Node.js.
Було корисно?
– вподобань · – переглядів
Часті запитання
Коли Node.js 26 стає LTS і скільки його підтримуватимуть?
Node.js 26 переходить в Active LTS 28 жовтня 2026 року, у режим Maintenance — 20 жовтня 2027-го, а підтримка закінчується 30 квітня 2029 року. Це найдовший запас серед актуальних версій.
Чи треба терміново оновлюватись з Node.js 24?
Ні. Node.js 24 отримує виправлення безпеки до 30 квітня 2028 року. Терміново потрібно інше: поставити патч 24.22.1 від 21 жовтня 2026. Перехід на 26 можна планувати спокійно, коли його підтримає ваш хостинг.
Що в Node.js 26 може зламати мій проєкт?
Найчастіше — нативні модулі, зібрані не на Node-API (новий NODE_MODULE_VERSION 147), видалені старі модулі _stream_*, метод writeHeader(), прапорець --experimental-transform-types і код, що розраховує на глобальний localStorage на сервері.
Чи можна вже використовувати Temporal замість Date?
У Node.js 26 Temporal увімкнено за замовчуванням, а TypeScript 6.0 має для нього вбудовані типи (lib esnext або esnext.temporal). Якщо частина коду ще працює на Node 22 чи 24, використовуйте поліфіл temporal-polyfill з тим самим API.
Чи підтримує Vercel Node.js 26?
Станом на кінець жовтня 2026 документація Vercel для збірок і функцій називає 24.x (за замовчуванням) і 22.x. Node.js 26 офіційно доступний у Vercel Sandbox. Перевірте розділ Node.js Version у налаштуваннях проєкту перед тим, як ставити engines: 26.x.