{"canonical_url":"https://engineer.company/uk/glossary/single-page-application/","content_markdown":"# Односторінковий застосунок\n\n## Що це таке\n\nОдносторінковий застосунок (англійською single-page application, скорочено SPA)\n— це вебзастосунок, який завантажує один HTML-документ, а далі змінює цей\nдокумент засобами JavaScript, замість того щоб просити в сервера нову сторінку.\nКлік на посилання всередині нього не змушує браузер залишити сторінку. Скрипт\nперехоплює клік, отримує дані, потрібні для наступного екрана, переписує частину\nDOM і оновлює адресний рядок, тож URL і далі показує, де перебуває читач.\n\nЖоден стандарт не володіє цим терміном, і ті, хто робить інструменти, це\nвизнають. Next.js починає свій посібник на цю тему словами «The definition of a\nSPA varies.», а потім задає власне визначення, яке називає strict SPA. У нього\nдві ознаки. Увесь застосунок віддається одним HTML-файлом, а кожен маршрут,\nкожен перехід між сторінками і кожне отримання даних обробляє JavaScript у\nбраузері. І повних перезавантажень сторінки немає: замість того щоб запитувати\nновий документ для кожного маршруту, JavaScript на клієнті змінює DOM поточної\nсторінки й отримує дані тоді, коли вони потрібні. Ця стаття користується саме\nцим визначенням, бо воно найпряміше з наявних і називає властивість, від якої\nзалежить усе інше, — документ, який ніколи не замінюється.\n\nБраузерні частини стандартні. Інтерфейс History зі стандарту HTML дає сторінці\n`history.pushState()`, що додає новий запис в історію сеансу й змінює URL,\nнічого не завантажуючи, і `history.replaceState()`, що натомість переписує\nпоточний запис. Коли читач переходить між цими записами кнопками «Назад» і\n«Вперед», браузер надсилає вікну подію `popstate` і залишає перемальовування\nсамій сторінці. Новіший Navigation API, який стандарт подає як наступника\nкласичних API location і history, заходить з іншого боку: подія `navigate`\nспрацьовує, коли навігація починається, а її метод `intercept()` перетворює цю\nнавігацію на навігацію в межах того самого документа, яку сторінка обробляє\nсама.\n\nПротилежність — звичайний багатосторінковий сайт, де кожне посилання просить у\nсервера свіжий документ, а браузер викидає старий. Чи HTML сторінки створює один\nраз генератор статичних сайтів, чи серверний рендеринг на кожен запит — окреме\nпитання. Воно про те, як HTML з'являється, а не про те, що відбувається, коли\nвін уже прийшов. Next.js свідомо розмиває цю межу: його статичний експорт\nзаписує HTML-файл для кожного маршруту, а переходи між ними однаково\nвідбуваються на клієнті.\n\n## Чому це важливо\n\nДокумент ніколи не замінюється, тож усе, що в ньому є, переживає клік:\nнаполовину заповнена форма, відео, що грає, позиція прокрутки бічної панелі, уже\nотримані дані. Мережею треба передати лише дані для наступного екрана, а не цілу\nнову сторінку з шапкою, стилями й скриптами. Зміна екрана може звестися до того,\nщоб переписати одну ділянку сторінки.\n\nNext.js називає ціну на одному подиху з визначенням. Strict SPA часто мусить\nзавантажити великий обсяг JavaScript, перш ніж сторінка стане інтерактивною, а\nкаскадами запитів на клієнті, коли один запит може початися лише після того, як\nповернувся інший, важко керувати. Платить і все, що читає сторінку без виконання\nскриптів. Коли за кожним маршрутом стоїть один HTML-файл, краулер, який не\nвиконує JavaScript, отримує той самий майже порожній документ, хоч би який URL\nвін запитав. Next.js каже те саме про власні компоненти, що працюють лише в\nбраузері: краулери, які не виконують JavaScript, бачать fallback замість\nкомпонента.\n\nВідповідь Next.js — зберегти навігацію на клієнті, а решту перенести. Next.js\nавтоматично розбиває JavaScript-бандли й генерує кілька HTML-точок входу для\nрізних маршрутів, тож відвідувач не завантажує коду, який маршруту не потрібен.\nКомпонент `next/link` заздалегідь завантажує маршрути, що дає швидкі переходи\nміж сторінками, як у strict SPA, і водночас тримає стан маршрутизації застосунку\nв URL, де на нього можна дати посилання й поділитися ним. Статичний експорт іде\nще далі й записує повністю відрендерену сторінку для кожного маршруту, тож\nвідвідувачі отримують вміст, не чекаючи клієнтського бандла, а переходи між\nсторінками на клієнті лишаються такими самими швидкими, як у strict SPA.\n\nІ вибір не робиться раз і назавжди. Next.js описує проєкт, який починається як\nстатичний сайт або навіть як strict SPA, що повністю рендериться на клієнті, і в\nміру зростання додає серверні можливості, а наявні SPA, за словами Next.js,\nможна перевести на нього без повного переписування.\n\n## Як це виглядає на практиці\n\nМаршрутизатор нижче написано для цієї статті, і це найменша робоча версія ідеї.\nВін припускає, що на сторінці є елемент `\u003cmain\u003e` і що сервер на кожен шлях\nзастосунку відповідає тим самим HTML-документом. Два екрани тут замінюють те, що\nзастосунок показує насправді.\n\n```js\n// router.js\nconst views = {\n  \"/\": { title: \"Orders\", text: \"Your recent orders.\" },\n  \"/settings\": { title: \"Settings\", text: \"Delivery preferences.\" },\n};\nconst main = document.querySelector(\"main\");\n\nfunction show(path, moveFocus) {\n  const view = views[path] ?? views[\"/\"];\n  const heading = document.createElement(\"h1\");\n  const body = document.createElement(\"p\");\n  heading.textContent = view.title;\n  heading.tabIndex = -1;\n  body.textContent = view.text;\n  main.replaceChildren(heading, body);\n  document.title = view.title;\n  if (moveFocus) heading.focus();\n}\n\ndocument.addEventListener(\"click\", (event) =\u003e {\n  const link = event.target.closest(\"a[href]\");\n  const modified = event.metaKey || event.ctrlKey || event.shiftKey;\n  if (!link || link.origin !== location.origin) return;\n  if (modified || event.button !== 0) return;\n  event.preventDefault();\n  history.pushState(null, \"\", link.href);\n  show(location.pathname, true);\n});\n\nwindow.addEventListener(\"popstate\", () =\u003e show(location.pathname, true));\nshow(location.pathname, false);\n```\n\nОбробник кліків перехоплює звичайні кліки лівою кнопкою на посиланнях того\nсамого походження (origin) і пропускає кліки з клавішами-модифікаторами, тож\nпосилання, як і раніше, можна відкрити в новій вкладці. `preventDefault()`\nзупиняє власну навігацію браузера, а `pushState()` додає в історію сеансу новий\nзапис з URL посилання. Середній аргумент існує лише з історичних причин, тому\nтут він порожній рядок. `show()` замінює екран, задає заголовок документа й\nпереводить фокус на новий елемент `h1`, який завдяки `tabIndex` зі значенням\n`-1` може отримати фокус зі скрипту, але не потрапляє в послідовність переходів\nклавішею Tab. Слухач `popstate` перемальовує відповідний екран, коли читач іде\nназад або вперед, а останній рядок малює екран для того URL, з яким сторінку відкрили, і це\nпрацює лише тоді, коли сервер віддає для `/settings` той самий документ, що й\nдля `/`. Справжній застосунок ще й показував би власний екран для невідомих\nадрес, а не тихо повертався б на стартову сторінку, і не чіпав би посилань на\nфайли та на інші частини сайту.\n\nУ поточній роботі засновниці в NextMariner фронтенд на Next.js 16 показує ціну\nцього підходу на справжньому продукті.\n[Сторінка портфоліо про цей фронтенд](/uk/portfolio/built-the-next-js-16-frontend-ssr-ssg-and-csr/)\nописує дашборд для автентифікованих користувачів, який мав бути відчутно швидким\nі водночас по-справжньому інтерактивним, і розповідає, що стається, коли всі\nдані отримують на клієнті: перше завантаження затягується, і з'являється патерн\nN+1, коли кожен компонент прокидається й надсилає власний запит, доки одна\nсторінка не перетвориться на каскад мережевих звернень. Це й є той каскад\nзапитів на клієнті, від якого застерігає посібник Next.js, тільки на практиці.\nРішення зберегло клієнтську інтерактивність там, де вона важлива, і перенесло\nперше отримання даних на сервер. У дашборді й на великих сторінках-каталогах\nфабрика `createPrefetchedServerPage` передає кожну сторінку клієнту вже з даними\nна місці. Про решту сторінка портфоліо говорить відверто: інші сторінки для\nавтентифікованих користувачів досі рендеряться на клієнті й чекають своєї черги,\nтож ідеться про перенесення, яке працює і вже знає, яку сторінку брати\nнаступною, а не про завершений перехід.\n\n## Де виникають проблеми\n\n**Кнопка «Назад» виводить із застосунку.** Якщо скрипт змінює екрани, не\nвикликаючи `pushState()`, в історії сеансу для них немає записів. «Назад»\nпроскакує всі екрани, які бачив читач, і зовсім виводить із застосунку, а\nперезавантаження веде на той URL, з яким застосунок відкрили першим. Варто\nдодавати запис для кожного екрана, який читач назвав би сторінкою,\nвикористовувати `replaceState()` для змін, що не мають ставати окремими кроками,\nяк-от фільтр, який саме набирають, і обробляти `popstate`. Next.js обстоює стан\nмаршрутизації в URL з тієї самої причини: саме це дає змогу послатися на екран і\nподілитися ним.\n\n**Пряме посилання натрапляє на сервер, що знає один файл.** У strict SPA один\nHTML-файл обслуговує кожен маршрут, але в адресному рядку видно `/settings`, і\nсаме цю адресу браузер запитує під час перезавантаження або коли хтось відкриває\nнадіслане посилання. Сервер, у якого є тільки `index.html`, відповідає кодом\n404. Вихід — або налаштувати сервер так, щоб на кожен шлях застосунку він\nвіддавав документ, або згенерувати файл для кожного маршруту. Статичний експорт\nNext.js робить друге: його тека `out` містить файли на кшталт `index.html`,\n`404.html` і `blog/post-1.html`, а посібник показує правило nginx\n`try_files $uri $uri.html $uri/ =404;`, яке зіставляє чистий URL з відповідним\nфайлом.\n\n**Фокус лишається там, де був старий екран.** `pushState()` змінює історію\nсеансу та URL і більше нічого. Після того як скрипт замінив екран, фокус\nклавіатури лишається на посиланні, по якому клікнули, або губиться, якщо\nелемент, що його тримав, видалено, і допоміжні технології дізнаються про новий\nекран лише тоді, коли сторінка сама їм про це повідомить. Варто задавати\nзаголовок документа і переводити фокус на заголовок нового екрана, як це робить\nприклад. Navigation API бере більше цієї роботи на себе. Навігація, оброблена\nчерез `intercept()`, за замовчуванням скидає фокус на перший елемент з\n`autofocus`, а якщо такого немає, то на body, і коли обробник завершиться,\nбраузер повідомляє користувачеві про завершення навігації, що, за словами\nстандарту, охоплює й допоміжні технології. Застосунок, який сам розставляє\nфокус, відмовляється від цього через `focusReset: \"manual\"`.\n\n**Усе оплачується наперед.** Strict SPA часто мусить завантажити великий обсяг\nJavaScript, перш ніж щось стане інтерактивним, а перші запити даних стартують\nлише тоді, коли цей код запуститься. Варто розбивати бандл за маршрутами, щоб\nвідвідувач завантажував лише те, що потрібно поточному екрану, і починати перші\nзапити на сервері. Патерн Next.js для цього отримує дані в Server Component, не\nчекаючи на результат, і передає проміс у Client Component, який розгортає його\nчерез `use()`. Якщо запит стартує ще до того, як відрендериться решта\nзастосунку, відповідь, за словами посібника, може відразу йти потоком, і\nкаскадів запитів на клієнті вдається уникнути.\n\n## Що почитати далі\n\n- [How to build single-page applications with Next.js](https://nextjs.org/docs/app/guides/single-page-applications)\n  — визначення strict SPA, його ціна і патерни, за допомогою яких Next.js\n  зберігає навігацію на клієнті, переносячи роботу на сервер.\n- [HTML Standard: The History interface](https://html.spec.whatwg.org/multipage/nav-history-apis.html#the-history-interface)\n  — `pushState()`, `replaceState()` і те, як записи історії сеансу додаються та\n  замінюються.\n- [HTML Standard: Navigation API](https://html.spec.whatwg.org/multipage/nav-history-apis.html#navigation-api)\n  — подія `navigate`, `intercept()` і обробка фокусу та прокрутки, що йде разом\n  із ними.\n- [How to create a static export of your Next.js application](https://nextjs.org/docs/app/guides/static-exports)\n  — один HTML-файл на маршрут, чого не вміє статичний експорт і як віддавати\n  чисті URL через nginx.\n\n\u003chttps://engineer.company/uk/glossary/single-page-application/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"Один HTML-документ, який JavaScript переписує, поки читач переходить між екранами: API браузера, ціна такого підходу і чотири типові пастки.","formats":{"gemtext":"https://engineer.company/uk/glossary/single-page-application/index.gmi","gopher":"https://engineer.company/uk/glossary/single-page-application/gophermap","html":"https://engineer.company/uk/glossary/single-page-application/","json":"https://engineer.company/uk/glossary/single-page-application/index.json","markdown":"https://engineer.company/uk/glossary/single-page-application/index.md","pdf":"https://engineer.company/uk/glossary/single-page-application/index.pdf"},"kind":"page","language":"uk","title":"Що таке односторінковий застосунок?","url":"https://engineer.company/uk/glossary/single-page-application/","version":1}