Nowy standard. Twoje centrum tworzenia inteligentnego, szybkiego i zrównoważonego oprogramowania AI
Single Page Application (SPA)
Single Page Application (SPA) to aplikacja internetowa, która ładuje jeden dokument HTML, a następnie za pomocą JavaScriptu zmienia jego treść w miarę poruszania się użytkownika po aplikacji, zamiast pobierać z serwera nową stronę.
Czym jest Single Page Application?
Kliknięcie linku na tradycyjnej stronie powoduje odrzucenie bieżącej strony i zbudowanie nowej od podstaw, nawet jeśli większość ekranu pozostaje bez zmian. Podejście SPA pozwala pominąć ten proces. Gdy aplikacja się załaduje, przechodzenie między widokami wymaga pobrania tylko tych danych, które się zmieniły, dzięki czemu rozbudowane, interaktywne narzędzia bardziej przypominają oprogramowanie desktopowe.
Za to podejście płaci się z góry. Przeglądarka musi pobrać kod JavaScript aplikacji, zanim pokaże cokolwiek użytecznego, a frontend przejmuje zadania, które wcześniej obsługiwał serwer, takie jak routing i zarządzanie stanem. W glosariuszu MDN poświęconym SPA wśród kosztów wymienia się trudniejsze pozycjonowanie w wyszukiwarkach i dodatkową pracę związaną z nawigacją.
Granica między SPA a tradycyjnymi stronami się zaciera. Meta-frameworki takie jak Next.js i Nuxt renderują pierwszą stronę po stronie serwera, a potem przekazują kontrolę JavaScriptowi, więc ten sam produkt przy pierwszym wczytaniu może działać jak tradycyjna strona, a później jak SPA.
Dlaczego model Single Page Application ma znaczenie?
Podnosi górny pułap interaktywności. Najwięcej zyskują produkty, w których użytkownicy przez dłuższy czas pracują na jednym ekranie, takie jak dashboardy czy edytory dokumentów, bo każde uniknięte przeładowanie eliminuje przerwę w pracy powtarzanej wiele razy dziennie.
Zmienia całą architekturę stosu technologicznego. Wybór SPA sprawia, że backend staje się API zwracającym dane zamiast stron. Taki podział pozwala jednemu API obsługiwać zarówno aplikację webową, jak i mobilną, ale oznacza też dwie bazy kodu do stworzenia i wdrożenia.
Jak działa Single Page Application?
Jeden początkowy dokument. Serwer zwraca minimalny plik HTML, często zawierający niewiele więcej niż pusty element kontenera i linki do bundli JavaScriptu.
Interfejs renderowany przez JavaScript. Framework taki jak React lub Vue buduje ekran wewnątrz tego kontenera i utrzymuje jego zgodność z danymi aplikacji.
Routing po stronie klienta. Gdy użytkownik klika link, router go przechwytuje i podmienia odpowiedni widok bez przeładowania, aktualizując pasek adresu za pomocą History API przeglądarki. Dokumentacja Google dotycząca wyszukiwania zaleca w tym celu History API zamiast fragmentów URL-i, czyli części po znaku #.
Dane przesyłane przez sieć. Każdy widok pobiera swoje dane z API, zwykle w formacie JSON, więc podczas nawigacji przesyłane są tylko te dane.
Stan przechowywany w pamięci. Informacje takie jak zalogowany użytkownik czy częściowo wypełniony formularz pozostają w pamięci przeglądarki przy przechodzeniu między widokami. Dzięki temu nawigacja jest natychmiastowa, ale pełne odświeżenie strony usuwa wszystko, czego nie zapisano na serwerze lub w pamięci przeglądarki.
Jakich narzędzi zespoły używają do budowy Single Page Application?
Frameworki i routery. React z React Routerem, Vue z Vue Routerem oraz Angular z wbudowanym routerem to popularne podstawy SPA.
Pobieranie danych i cache. TanStack Query i SWR zapisują odpowiedzi API w pamięci podręcznej przeglądarki, więc po powrocie do widoku można od razu wyświetlić dane, podczas gdy ich świeża wersja ładuje się w tle.
Budowanie i hosting. Vite przygotowuje aplikację do środowiska produkcyjnego. Hostingi statyczne, takie jak Netlify czy Cloudflare Pages, serwują te pliki, z regułą rewrite kierującą każdy URL do tego samego pliku index.html.
Jakie są najważniejsze cechy Single Page Application?
Treść zależy od JavaScriptu. Gdy JavaScript jest wyłączony albo przestaje działać, SPA renderowane wyłącznie po stronie klienta pokazuje pustą stronę. Nieobsłużony błąd podczas uruchamiania może wyczyścić cały interfejs, a nie tylko widżet, który zawiódł.
Cięższe pierwsze ładowanie, lżejsza nawigacja. Przy pierwszej wizycie pobierany jest kod aplikacji. Później podczas nawigacji przesyłane są już tylko dane, więc koszt SPA skupia się na początku sesji.
To aplikacja decyduje, co pokazuje każdy adres URL. Serwer zwraca ten sam dokument dla każdej ścieżki, więc sama aplikacja musi obsługiwać brakujące strony. Google zaleca przekierowanie na adres URL, który zwraca status 404, albo dodanie tagu noindex do widoków błędów, żeby uszkodzone linki nie były indeksowane jako „soft 404”.
Długowieczne strony. Użytkownik może trzymać jedną kartę SPA otwartą przez wiele godzin albo dni, więc wycieki pamięci i nieaktualny kod mają większe znaczenie niż na stronach przeładowywanych po każdym kliknięciu.
Jakie są zalety Single Page Application?
Natychmiastowe zmiany widoku. Po pierwszym załadowaniu przełączanie między widokami nie wymaga pobierania całej strony, więc interfejs reaguje bez pustego błysku przy przeładowaniu.
Mniejsze obciążenie serwera przy każdej nawigacji. Zamiast renderować pełną stronę HTML przy każdym kliknięciu, serwer wysyła niewielkie odpowiedzi z danymi.
Niedrogi hosting frontendu. Zbudowana aplikacja jest zestawem plików statycznych, które może serwować CDN, bez potrzeby uruchamiania serwera renderującego strony.
Droga do działania offline. Ponieważ szkielet aplikacji jest już w przeglądarce, SPA można rozbudować do progressive web app, która buforuje dane i działa dalej nawet przy słabym połączeniu.
Jakie wyzwania wiążą się z Single Page Application?
Widoczność w wyszukiwarkach. Google renderuje JavaScript, ale strony trafiają do kolejki renderowania, która według Google może trwać dłużej niż kilka sekund, a dodatkowo firma zaznacza, że „nie wszystkie boty potrafią uruchamiać JavaScript”. Renderowanie po stronie serwera albo pre-rendering usuwa tę zależność, ale wymaga serwera do uruchomienia albo kroku builda, który musi odtwarzać strony za każdym razem, gdy zmienia się treść.
Powolne pierwsze ładowanie. Duże bundle JavaScriptu opóźniają pojawienie się pierwszego użytecznego widoku, szczególnie na telefonach ze średniej półki. Code splitting ładuje tylko to, czego potrzebuje dany widok, ale wprowadza stany ładowania, które zespół musi zaprojektować w każdym punkcie podziału.
Odtwarzanie podstawowych mechanizmów przeglądarki. Zachowania, które przeglądarka zapewnia tradycyjnym stronom automatycznie, takie jak przywracanie pozycji przewijania czy przenoszenie fokusu czytnika ekranu do nowej treści, aplikacja musi obsłużyć sama. Routery obejmują tylko część tych przypadków, a testy dostępności muszą potwierdzić resztę.
Trudniejsza analityka. Narzędzia oparte na ładowaniu stron nie wychwytują nawigacji wewnątrz aplikacji, jeśli nie zostaną skonfigurowane do śledzenia zmian tras. Taka konfiguracja przywraca dokładność danych, ale dodaje własny kod śledzący, który może po cichu przestać działać po zmianie nazw tras.
Jaka jest różnica między Single Page Application a Multi-Page Application?

Aspekt | Single Page Application (SPA) | Multi-Page Application (MPA) |
Pierwsza odpowiedź z serwera | Minimalny szkielet HTML plus bundle JavaScriptu | Kompletna strona HTML z treścią |
Przechodzenie między stronami | JavaScript podmienia widok bez pełnego przeładowania | Przeglądarka żąda nowej strony HTML i ją wczytuje |
Indeksowanie przez wyszukiwarki | Zależy od tego, czy crawlery uruchamiają JavaScript, chyba że dodasz renderowanie po stronie serwera albo pre-rendering | Treść znajduje się w HTML-u już w pierwszej odpowiedzi |
Stan interfejsu między stronami | Przechowywany w pamięci przeglądarki | Resetowany przy każdym załadowaniu strony, chyba że jest zapisany na serwerze albo w pamięci przeglądarki |
Typowe zastosowanie | Dashboardy i narzędzia używane po zalogowaniu | Serwisy contentowe i katalogi produktów |
Co działa po stronie serwera | API, a frontend jest serwowany jako pliki statyczne | Serwer albo krok builda, który generuje HTML dla każdej strony |
FAQ o Single Page Application (SPA)
Single Page Application (SPA): potrzebujesz wsparcia ekspertów?
Monterail tworzy oprogramowanie na zamówienie z wykorzystaniem najnowszych technologii. Porozmawiajmy o tym, jak możemy pomóc w Twoim projekcie.