{"canonical_url":"https://engineer.company/uk/glossary/nextjs/","content_markdown":"# Next.js\n\n## Що це таке\n\nNext.js — це фреймворк, що обгортає React, бібліотеку для побудови інтерфейсів із компонентів, і\nдодає те, що React лишає кожному застосунку: маршрутизацію, рендеринг на сервері, отримання даних і\nвже налаштовану збірку. Пакет і його команда звуться `next`, як у `next dev` і `next build`.\n\nУперше його випустили 2016 року, [за словами авторів](https://nextjs.org/blog/next-13-4), щоб дати\nпростий спосіб рендерити застосунки React на сервері. Ранній дизайн спирався на кілька принципів:\nробота без налаштувань, файлова система як API, тож файл у теці `pages/` ставав маршрутом,\nавтоматичний рендеринг на сервері й поділ коду, а отримання даних лишалося на розсуд розробника.\n2023 року примітки до випуску дякували понад 2 600 розробникам разом з основною командою у Vercel.\n\nNext.js 13 від 25 жовтня 2022 року додав теку `app` у бета-версії, побудовану на\n[React Server Components](https://react.dev/reference/rsc/server-components), із вкладеними макетами\nй потоковою передачею. Next.js 13.4 від 4 травня 2023 року оголосив цей App Router стабільним, і\nвідтоді документація описує два маршрутизатори. Pages Router вона називає початковим\nмаршрутизатором, який досі підтримують і вдосконалюють. Вони працюють навіть на різних версіях\nReact: App Router має вбудовані canary-випуски React, а Pages Router використовує ту версію, яку\nвказано в `package.json` проєкту. В App Router сторінки й макети рендеряться на сервері, якщо файл\nне обирає браузер директивою `\"use client\"`.\n\nNext.js 16 вийшов 21 жовтня 2025 року. Він зробив Turbopack типовим бандлером, перейменував файл\n`middleware.ts` на `proxy.ts` і запровадив Cache Components — модель, у якій директива `\"use cache\"`\nпозначає те, що можна кешувати, а все інше рендериться під час запиту. Next.js 16.4 від 6 жовтня\n2026 року радить Cache Components для кожного застосунку, вмикає їх у нових проєктах, створених\nчерез `create-next-app`, і обіцяє, що вони стануть типовими в Next.js 17.\n\n## Чому це важливо\n\nРішення, на яке відповідає Next.js, таке: чи віддати фреймворку маршрутизацію, рендеринг і сервер\nзастосунку на React, чи зібрати ці частини самотужки й лишити вибір за собою.\n\nФреймворк пропонує домовленості замість конфігурації. Маршрути беруться з файлів, бандлери й\nкомпілятори налаштовуються автоматично, а кожен маршрут можна зібрати заздалегідь, рендерити на\nсервері під час кожного запиту або рендерити в браузері. Server Components тримають доступ до даних\nі секрети на сервері й надсилають у браузер менше JavaScript. Для застосунку, що поєднує публічні\nсторінки із зоною після входу та власним бекендом, саме цей вибір для кожного маршруту приваблює\nнайбільше.\n\nПерша ціна — сервер із Node.js 20.9 або новішим для Next.js 16. Параметр `output: 'export'` записує\nпо одному HTML-файлу на маршрут для будь-якого статичного вебсервера, і посібник подає це як спосіб\nпочати статично й додати серверні можливості пізніше. Проте його перелік того, що потребує сервера\nNode.js, охоплює чимало з того, чим Next.js вирізняється: Proxy, Server Actions, файли cookie, переписування URL,\nпереспрямування, заголовки, інкрементну статичну регенерацію (ISR) і оптимізацію зображень типовим завантажувачем.\n\nДруга ціна — темп. За рік після 16.0 вийшло ще чотири випуски з новими можливостями, і модель\nкешування от-от знову змінить типову поведінку. Примітки до 16.4 кажуть, що Cache Components\nзамінюють неявне кешування попередніх версій App Router, тож код, написаний для Next.js 13–15, кешує\nза іншими правилами. Посібники в мережі теж поділені між двома маршрутизаторами.\n\nТретя ціна — оновлення стають роботою з безпеки. 3 грудня 2025 року проєкт оприлюднив попередження\nпро CVE-2025-66478, критичну вразливість у протоколі React Server Components, і закликав негайно\nоновитися до виправлених версій, а між 30 вересня і 14 жовтня 2026 року блог опублікував ще три\nдописи про безпеку. Команда, що обирає Next.js, бере на себе обов'язок уважно стежити за його\nвипусками. Команда, що публікує документи, однакові для кожного відвідувача, платить за серверну\nмодель, якою майже не користується.\n\n## Як це виглядає на практиці\n\nУ роботі засновниці в NextMariner фронтенд на Next.js 16\n[обирає режим для кожної частини](/uk/portfolio/built-the-next-js-16-frontend-ssr-ssg-and-csr/),\nі це вибір для кожного маршруту в дії. Маркетингові й публічні сторінки генеруються статично,\nсправді інтерактивні частини й далі рендеряться на клієнті, а в дашборді для автентифікованих\nкористувачів і на великих сторінках-каталогах фабрика `createPrefetchedServerPage` отримує дані\nсторінки на сервері й передає їх клієнту, який відразу має потрібні дані. Сторінки переносять на фабрику по одній, і\nсторінка про цю роботу чесно визнає, що решта застосунку для автентифікованих користувачів досі\nрендериться на клієнті й чекає свого часу: це «перенесення з робочим механізмом і очевидною\nнаступною сторінкою, а не завершений перехід». App Router задумано саме для такого переходу:\nпримітки до 13.4 описують його поступове впровадження.\n\nБагаторівневий\n[набір тестів](/uk/portfolio/built-a-test-suite-across-go-sql-and-browser/) відводить\nфронтенду на Next.js окремий рівень: 543 специфікації Vitest і Playwright, зокрема 48 файлів\nнаскрізних тестів і 30 браузерних специфікацій, поряд з окремими рівнями для API на Go і бази даних.\nПоведінку кожного рівня перевіряють там, де вона живе, а не все ззовні через браузер, і у\nфреймворку, де одне дерево компонентів працює частково на сервері, а частково в браузері, це важить\nбільше, ніж зазвичай.\n\nКоли засновниця, працюючи в NextMariner,\n[посилила захист застосунку](/uk/portfolio/hardened-the-application-with-nonce-based-csp/),\nзахисні механізми, звернені до браузера, опинилися в `proxy.ts`, перейменованому middleware.\nProxy виконується раніше за маршрут, тож саме тут кожен запит отримує власний nonce, який іде в\nContent-Security-Policy поряд зі `strict-dynamic`; тут же виставляються HSTS і SameSite cookies.\nПрава доступу живуть деінде: тариф, роль, організацію й прив'язку до судна сервер повторно\nперевіряє під час кожного запиту, а обмеження на фронтенді вважаються суто питанням UX.\nТакий поділ узгоджується з довідником з Proxy, який називає цю можливість крайнім засобом і радить\nперевіряти авторизацію всередині кожної Server Function, а не покладатися лише на Proxy.\n\n## Де виникають проблеми\n\n**Після додавання переспрямування на вхід сторінка входу завантажується без стилів.** Без `matcher`\nProxy працює на кожному запиті, зокрема для зібраних файлів у `_next/static`, оптимізованих\nзображень у `_next/image` і всього в `public/`, тож переспрямування, призначене для сторінок,\nперехоплює й CSS, JavaScript і зображення, потрібні сторінці входу. Дайте Proxy matcher, що\nпропускає ці шляхи:\n\n```ts\n// proxy.ts\nexport const config = {\n    matcher: [\"/((?!_next/static|_next/image|favicon.ico).*)\"],\n};\n```\n\nФайли з `public/` не мають спільного префікса, тож додайте і їхні шляхи.\n\n**Дія форми спрацьовує для користувача, який не ввійшов, на маршруті, що виглядає захищеним.**\nServer Functions не мають власних маршрутів: вони надходять як POST-запити на сторінку, де їх\nвикористано, тож matcher, який виключає шлях із перевірки Proxy, виключає з неї й функції на ньому. Довідник з Proxy\nпопереджає, що зміна matcher або рефакторинг, який переносить функцію на інший маршрут, може\nнепомітно зняти покриття Proxy. Перевіряйте сесію й права користувача всередині кожної Server\nFunction і вважайте Proxy зовнішнім шаром, а не єдиним.\n\n**Користувач зберігає зміну, а сторінка досі показує старе значення.** У Next.js 16\n`revalidateTag(tag, 'max')` дає позначеним записам поведінку stale-while-revalidate: кешована копія\nй далі віддається, поки отримується свіжа, що пасує вмісту, для якого припустима узгодженість із затримкою, і\nдивує людину, яка щойно натиснула «Зберегти». Викликайте `updateTag(tag)` з тієї Server Action, що\nвнесла зміну: вона негайно анулює кешований запис і читає свіжі дані в межах того самого запиту. Стара\nформа з одним аргументом, `revalidateTag(tag)`, оголошена застарілою й тепер дає помилку TypeScript.\n\n**Codemod для оновлення завершується, а збірка досі падає на `params` або `cookies()`.** Next.js 15\nзробив API запиту асинхронними з тимчасовою синхронною сумісністю, а Next.js 16 її прибирає. Codemod\n`upgrade` виконує не всі потрібні перетворення коду, тож запустіть також `npx @next/codemod@canary\nnext-async-request-api .`, а потім `npx next typegen`, щоб згенерувати допоміжні типи `PageProps`,\n`LayoutProps` і `RouteContext`. Те саме оновлення прибирає `next lint`, а `next build` більше не\nзапускає лінтер, тож додайте ESLint або Biome окремим кроком.\n\n## Що почитати далі\n\n- [Next.js Docs](https://nextjs.org/docs) — офіційна документація з перемикачем між версіями кожної\n  сторінки для App Router і Pages Router.\n- [Next.js 16](https://nextjs.org/blog/next-16) — випуск, що приніс Cache Components, `proxy.ts` і\n  Turbopack як типовий бандлер, разом з несумісними змінами.\n- [How to upgrade to version 16](https://nextjs.org/docs/app/guides/upgrading/version-16) —\n  codemod-и, вимоги до версій і кожен вилучений чи перейменований API.\n- [proxy.js](https://nextjs.org/docs/app/api-reference/file-conventions/proxy) — matcher-и, місце\n  Proxy в порядку обробки запиту і причина, з якої middleware перейменували.\n- [Next.js 16.4](https://nextjs.org/blog/next-16-4) — аргументи на користь Cache Components і план\n  зробити їх типовими в Next.js 17.\n- [How to create a static export](https://nextjs.org/docs/app/guides/static-exports) — що записує\n  `output: 'export'` і яким можливостям потрібен сервер.\n\n\u003chttps://engineer.company/uk/glossary/nextjs/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"Що Next.js додає до React, коли окупається його серверна модель і які пастки Proxy, кешування й оновлень чатують на команди, що переходять на версію 16.","formats":{"gemtext":"https://engineer.company/uk/glossary/nextjs/index.gmi","gopher":"https://engineer.company/uk/glossary/nextjs/gophermap","html":"https://engineer.company/uk/glossary/nextjs/","json":"https://engineer.company/uk/glossary/nextjs/index.json","markdown":"https://engineer.company/uk/glossary/nextjs/index.md","pdf":"https://engineer.company/uk/glossary/nextjs/index.pdf"},"kind":"page","language":"uk","title":"Що таке Next.js?","url":"https://engineer.company/uk/glossary/nextjs/","version":1}