{"canonical_url":"https://engineer.company/uk/glossary/server-side-rendering/","content_markdown":"# Серверний рендеринг\n\n## Що це таке\n\nСерверний рендеринг (англійською server-side rendering, скорочено SSR), який ще\nназивають рендерингом на стороні сервера, означає, що HTML сторінки формується\nна сервері в ту мить, коли хтось її запитує. Браузер отримує готовий документ,\nде вміст уже на місці, і може показати його ще до того, як виконається бодай\nодин скрипт. У JavaScript-фреймворку ті самі компоненти потім виконуються\nвдруге, уже в браузері, який підхоплює надісланий HTML і робить його\nінтерактивним.\n\nЦей термін відповідає на питання про час: коли і де створюється HTML?\nПоширених відповідей три. Генератор статичних сайтів створює його один раз, під\nчас збирання сайту, і віддає всім той самий файл. Серверний рендеринг створює\nйого на сервері для кожного запиту, тож сторінка може залежати від того, хто\nпитає і що саме кажуть дані в цю мить. Клієнтський рендеринг, який часто\nназивають CSR, надсилає майже порожній документ і пакет JavaScript, що будує\nсторінку просто в браузері. Справжні застосунки часто поєднують усі три\nпідходи, маршрут за маршрутом.\n\nNext.js описує це так само. Його документація наводить dynamic rendering як\nіншу назву SSR і пояснює, що HTML сторінки генерується на кожен запит. У Pages\nRouter сторінка обирає цей режим, експортуючи асинхронну функцію\n`getServerSideProps`, яку сервер викликає на кожен запит; споріднена\n`getStaticProps` робить ту саму роботу один раз, під час збирання. Механізм під\nкапотом дає React. API з `react-dom/server` перетворюють дерево компонентів на\nHTML на сервері: або потоком, через `renderToPipeableStream` для Node.js і\n`renderToReadableStream` для Web Streams, або одним шматком через старішу\n`renderToString`, яку React відносить до legacy-API з обмеженою\nфункціональністю.\n\nДруга половина відбувається в браузері й називається гідратацією. Next.js\nописує перше завантаження так: HTML дає швидкий неінтерактивний попередній\nперегляд, а потім JavaScript гідратує компоненти. Саму гідратацію Next.js\nвизначає як спосіб, у який React прив'язує обробники подій до DOM, щоб\nстатичний HTML став інтерактивним. Довідка React до `hydrateRoot` не приховує\nкомпромісу: знімок у HTML створює враження, що застосунок завантажується\nшвидше, і якусь мить сторінка виглядає готовою, хоча ще такою не є.\n\n## Чому це важливо\n\nВміст є вже в першій відповіді. Читач на повільному з'єднанні бачить текст і\nзображення, поки JavaScript ще в дорозі, а краулер, який не виконує JavaScript,\nбачить ту саму сторінку, що й людина, а не порожню оболонку. Браузерові не\nтреба спершу виконати скрипт, а потім завантажити дані, щоб намалювати\nсправжній вміст.\n\nСторінка також може залежати від запиту, і саме це відрізняє її від статичного\nзбирання. Next.js радить `getServerSideProps` для даних, які стосуються\nконкретного користувача або стають відомі лише під час запиту, як-от заголовок\nauthorization чи місцезнаходження відвідувача, а все інше відсилає до генерації\nпід час збирання. Дані отримують поруч із тим місцем, де вони зберігаються. Код\nу функції виконується лише на сервері, її імпорти не потрапляють до\nклієнтського бандла, і вона може звертатися до бази даних чи CMS напряму. Один\nпохід на сервер може замінити запити, які браузер інакше надсилав би один за\nодним, щойно завантажаться його скрипти.\n\nЦіна тут — дзеркальне відображення того, що заощаджує статичний сайт. Потрібен\nзапущений сервер, і він виконує рендеринг заново для кожного запиту. Відповідь\nможе початися лише тоді, коли дані готові, тож без потокової передачі\nнайповільніший запит до даних задає темп усій сторінці. До того ж рендеринг на\nсервері не прибирає JavaScript: браузер усе одно завантажує кожен компонент,\nякий має гідратувати, і доки гідратація не завершиться, кнопка може бути\nнамальована на екрані, але нічого не робити.\n\nТому вибір робиться для кожної сторінки окремо, а не для всього проєкту.\nСторінка, однакова для всіх читачів, мало виграє від повторного рендерингу на\nкожен запит, а сторінка, що змінюється разом із читачем або з даними, які\nоновлюються щохвилини, якраз і виправдовує для SSR окремий сервер. Цей сайт\nстоїть на статичному кінці шкали. Набір [технологій](/uk/tech-stack/) сайту\nставить статику на перше місце там, де це доречно, тож ці сторінки не потребують виконання застосунку під час запиту, а збирає сайт Hugo.\n\n## Як це виглядає на практиці\n\nСторінку нижче написано для цієї статті, і вона використовує Pages Router. Вона\nпоказує замовлення клієнта, що увійшов у систему, відправляє відвідувача без\nсесії на сторінку входу й просить усі кеші не зберігати результат.\n`readSession` і `db` позначають те, що застосунок використовує для сесій і\nданих.\n\n```jsx\n// pages/orders.js\nexport async function getServerSideProps({ req, res }) {\n  const session = await readSession(req.cookies.session);\n  if (!session) {\n    return { redirect: { destination: \"/sign-in\", permanent: false } };\n  }\n\n  const rows = await db.orders.listFor(session.userId);\n  res.setHeader(\"Cache-Control\", \"no-store\");\n\n  return {\n    props: {\n      orders: rows.map((o) =\u003e ({\n        id: o.id,\n        number: o.number,\n        status: o.status,\n      })),\n    },\n  };\n}\n\nexport default function Orders({ orders }) {\n  return (\n    \u003cul\u003e\n      {orders.map((o) =\u003e (\n        \u003cli key={o.id}\u003e\n          {o.number}: {o.status}\n        \u003c/li\u003e\n      ))}\n    \u003c/ul\u003e\n  );\n}\n```\n\nNext.js виконує цю функцію на кожен запит до `/orders`. `req.cookies` — це\nзаголовок Cookie запиту, уже розібраний. `redirect` із `permanent: false` —\nтимчасове перенаправлення, а не постійне. Усе, що повертається в `props`, має\nпережити `JSON.stringify` і потрапляє також у браузер як частина початкового\nHTML, щоб React міг гідратувати список тими самими даними, які використав\nсервер. Тому функція зводить кожен рядок до трьох полів, які показує сторінка,\nа не передає рядки бази даних як є. Коли читач згодом приходить за посиланням\n`next/link`, Next.js просить сервер виконати функцію ще раз і отримує props у\nвигляді JSON, без повного завантаження сторінки.\n\nФронтенд на Next.js 16 з поточної роботи засновниці в NextMariner показує, яку\nпроблему це розв'язує. [Сторінка портфоліо про цей\nфронтенд](/uk/portfolio/built-the-next-js-16-frontend-ssr-ssg-and-csr/)\nпочинається з дашборду для автентифікованих користувачів, який мав бути відчутно\nшвидким і водночас інтерактивним. Якщо отримувати всі дані в браузері, перше\nзавантаження затягується, і з'являється патерн N+1: кожен компонент прокидається\nй надсилає власний запит, і одна сторінка перетворюється на каскад мережевих\nзвернень. У дашборді й на великих сторінках-каталогах фабрика\n`createPrefetchedServerPage` тепер отримує дані сторінки на сервері й передає їх\nклієнтові вже готовими до використання, тож компоненти одразу мають свої дані, а\nне йдуть по них кожен окремо. Сторінки, перенесені на фабрику, завантажуються за\nодне звернення замість цілої зливи звернень. Два інші режими проєкт залишає там,\nде вони доречні: публічні сторінки генеруються статично, бо не залежать від\nкористувача, а справді інтерактивні частини й далі рендеряться на клієнті.\nСтратегію інвалідації кешу задокументовано для кожного запиту, тож дані\nлишаються актуальними, а застосунок не завантажує вдруге те, що вже має.\n\n## Де виникають проблеми\n\n**Сервер і браузер розходяться.** Гідратація очікує, що перший рендер у\nбраузері дасть той самий результат, що й на сервері. Компонент, який перевіряє\n`typeof window`, викликає `window.matchMedia` під час рендерингу або виводить\nпоточний час, рендерить одне на сервері й інше в браузері. Серед причин React\nтакож називає різні дані на двох боках і зайві пробіли всередині кореневого\nелемента. У кращому разі розбіжність сповільнює гідратацію, а в гіршому\nобробники подій опиняються не на тих елементах, тож довідка React до\n`hydrateRoot` каже прямо: «You should treat mismatches as bugs and fix them.»\nВихід — рендерити те саме на обох боках. Там, де браузер справді мусить\nпоказати щось інше, спершу рендерять серверну версію, а після гідратації\nперемикаються в ефекті (effect), і це коштує ще одного рендеру.\n`suppressHydrationWarning` доречний лише для неминучої різниці на кшталт\nпозначки часу, і діє він тільки на один рівень углиб.\n\n**Секрети потрапляють у props.** Усе, що повертається як props, записується в\nпочатковий HTML, щоб браузер міг гідратувати сторінку, і документація Next.js\nзастерігає не передавати так нічого чутливого. Функція, яка повертає повний\nзапис користувача, віддає хеш його пароля й внутрішні прапорці кожному, хто\nвідкриє вихідний код сторінки. Повертати варто лише ті поля, які сторінка\nпоказує, як це робить приклад вище.\n\n**Спільний кеш віддає сторінку одного читача наступному.** Документація Next.js\nілюструє кешування сторінок, відрендерених на сервері, заголовком\n`Cache-Control: public, s-maxage=10, stale-while-revalidate=59`. Перенесений на\nперсоналізовану сторінку, такий заголовок запрошує CDN або проксі перед\nсервером зберегти відповідь і віддати її тому, хто запитає наступним. RFC 9111\nвизначає `public` як дозвіл кешу зберегти відповідь, яку він інакше відкинув\nби, а `s-maxage` — як час життя, призначений для спільних кешів. Кожна з цих\nдиректив до того ж знімає правило, за яким спільний кеш не може повторно\nвикористати відповідь на запит із заголовком `Authorization`. Сторінці,\nпобудованій із cookie чи облікових даних, потрібен `private`, що забороняє\nспільним кешам її зберігати, або `no-store`, що забороняє це всім кешам.\n\n**Найповільніший запит затримує всю сторінку.** Якщо сторінку рендерити одним\nшматком, вона нічого не надсилає, доки не повернеться кожен запит за нею, тож\nодин повільний запит затримує шапку, навігацію і все інше. Потоковий рендерер\nReact ділить сторінку на межах `\u003cSuspense\u003e`. Він надсилає оболонку, тобто все\nпоза межами, щойно вона готова, із fallback-ами на місцях, а потім потоком\nдосилає кожну частину, що лишилася, з невеликим вбудованим скриптом, який її\nвставляє. Із раннього надсилання випливає одна заковика: коли потік почався,\nкод статусу вже не можна змінити, тож ситуацію з відсутнім записом чи невдалою перевіркою\nтреба обробити до того, як піде оболонка, і саме в `onShellError`\nвстановлюють статус помилки.\n\n## Що почитати далі\n\n- [Server-side Rendering (SSR)](https://nextjs.org/docs/pages/building-your-application/rendering/server-side-rendering)\n  — Next.js про HTML, що генерується на кожен запит, і про те, чим\n  `getServerSideProps` відрізняється від `getStaticProps`.\n- [getServerSideProps](https://nextjs.org/docs/pages/building-your-application/data-fetching/get-server-side-props)\n  — коли її використовувати, що потрапляє до клієнта в початковому HTML і як\n  кешувати з `Cache-Control`.\n- [Server React DOM APIs](https://react.dev/reference/react-dom/server) —\n  потокові та legacy-API, які React пропонує для рендерингу компонентів у HTML\n  на сервері.\n- [hydrateRoot](https://react.dev/reference/react-dom/client/hydrateRoot) — як\n  React підхоплює відрендерений на сервері HTML і типові причини розбіжностей\n  під час гідратації.\n- [renderToPipeableStream](https://react.dev/reference/react-dom/server/renderToPipeableStream)\n  — оболонка, межі `\u003cSuspense\u003e` і застереження щодо коду статусу під час\n  потокової передачі.\n- [RFC 9111: HTTP Caching](https://www.rfc-editor.org/rfc/rfc9111.html) —\n  директиви `public`, `private`, `s-maxage` і `no-store` та правила для спільних\n  кешів.\n\n\u003chttps://engineer.company/uk/glossary/server-side-rendering/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"HTML сторінки, сформований на сервері для кожного запиту: чим це відрізняється від статичних сторінок і рендерингу в браузері, гідратація і чотири пастки.","formats":{"gemtext":"https://engineer.company/uk/glossary/server-side-rendering/index.gmi","gopher":"https://engineer.company/uk/glossary/server-side-rendering/gophermap","html":"https://engineer.company/uk/glossary/server-side-rendering/","json":"https://engineer.company/uk/glossary/server-side-rendering/index.json","markdown":"https://engineer.company/uk/glossary/server-side-rendering/index.md","pdf":"https://engineer.company/uk/glossary/server-side-rendering/index.pdf"},"kind":"page","language":"uk","title":"Що таке серверний рендеринг?","url":"https://engineer.company/uk/glossary/server-side-rendering/","version":1}