Ponad co trzeci popularny serwis na frameworku JavaScript, który sprawdziłem, tracił bez JavaScriptu ważną treść, kiedy porównałem HTML wysyłany przez serwer z wyrenderowaną stroną. Gdy w listopadzie 2026 ponownie sprawdziłem te same strony główne, werdykt zmienił się tylko u trzech z 83 serwisów, które dało się porównać w obu pomiarach.
Google sobie z takimi stronami radzi, ale większość robotów AI czyta tylko to, co od razu wyśle twój serwer. Niżej pokazuję, jak w kilka minut sprawdzić JavaScript SEO na własnej stronie i co naprawić najpierw. Skrypty i dane są w pakiecie badania.
Co to jest JavaScript SEO?
JavaScript SEO to praca nad tym, żeby wyszukiwarki i roboty AI mogły pobrać, przeczytać i zaindeksować treść, którą strona buduje w JavaScripcie. Każda twoja strona istnieje w dwóch wersjach. HTML z serwera pokazuje ci curl albo „Wyświetl źródło strony” (Ctrl+U), a wyrenderowany DOM widzisz w panelu Elementy (Elements), kiedy skrypty już zadziałają.
To, jak bardzo te wersje się różnią, zależy od sposobu, w jaki twój framework renderuje stronę.
| Sposób renderowania | Gdzie powstaje HTML | Co dostaje robot bez JavaScriptu |
|---|---|---|
| Renderowanie po stronie klienta (CSR) | W przeglądarce odwiedzającego | Pustą skorupę, często samo <div id="root"> |
| Renderowanie po stronie serwera (SSR) | Na serwerze, przy każdym żądaniu | Całą stronę, którą JavaScript potem ożywia (hydratacja) |
| Generowanie statyczne (SSG) | Na serwerze, raz przy budowaniu | Całą stronę z pliku |
| Hybryda | Część na serwerze, część w przeglądarce | To, co zawiera część serwerowa |
Jak Google renderuje strony w JavaScripcie
Google obsługuje strony w JavaScripcie w trzech fazach, a między skanowaniem i indeksowaniem stoi kolejka renderowania. Według dokumentacji Google o podstawach JavaScript SEO strona czeka w niej kilka sekund, ale bywa, że dłużej. Potem Chromium bez interfejsu uruchamia skrypty.
Ja bardziej zwróciłbym uwagę na dwa inne szczegóły z tego dokumentu. Przy pierwszym przejściu Google znajduje linki tylko w elementach <a> z atrybutem href, więc nawigacja wstrzyknięta przez skrypt czeka na drugie przejście. Google pisze też, że renderowanie po stronie serwera albo prerendering to dalej świetny pomysł, bo strona działa szybciej, a nie każdy bot potrafi uruchomić JavaScript.
Google zwykle więc zobaczy treść renderowaną w przeglądarce, tylko później i po drodze przez więcej kroków, na których coś może się wysypać, np. przez limit czasu albo błąd skryptu. A Google to tylko jeden z robotów, które odwiedzają twoją stronę.
Roboty AI czytają tylko HTML z serwera
Większość robotów AI czyta HTML wysłany przez serwer i pomija JavaScript. Vercel razem z MERJ przejrzał ruch robotów AI w swojej sieci w tekście The rise of the AI crawler. Ustalił, że żaden z dużych robotów AI nie renderuje JavaScriptu, poza AppleBotem i Gemini, który korzysta z infrastruktury Googlebota. Roboty stojące za ChatGPT i Claude pobierają nawet pliki ze skryptami, ale ich nie wykonują.
Ta analiza ma już swoje lata, więc poszukałem nowszej. Resoneo postawił stronę testową z 15 sposobami wstawiania treści i poprosił asystentów, żeby ją przeczytali.
W teście Resoneo ChatGPT i Claude czytały tylko statyczny HTML, kiedy użytkownik kazał im otworzyć stronę. Tak samo zachowało się pobieranie na żywo w Gemini, a Perplexity dostał pustą odpowiedź. JavaScript uruchomiły Bing Copilot i Grok, przy czym Copilot czekał na treść ułamek sekundy.
Po ludzku: jeśli opisy produktów albo tekst artykułów pojawiają się dopiero po uruchomieniu JavaScriptu, asystenci, których pytają twoi klienci, nie mają czego zacytować.
Co trzecia strona na frameworku JavaScript traci treść bez JavaScriptu
Ponad co trzeci serwis na frameworku JavaScript w mojej próbie tracił w HTML-u z serwera ważną treść, i to w obu pomiarach. Chodzi o to, że ważny znacznik, np. H1 albo canonical, pojawiał się dopiero po JavaScripcie, albo w HTML-u z serwera była mniej niż połowa tekstu lub linków.
Najczęściej znikał tekst, potem linki wewnętrzne i H1. Tytuł przetrwał prawie wszędzie i moim zdaniem właśnie przez to problem tak dobrze się chowa. Karta przeglądarki i opis w wynikach wyglądają dobrze, a pod spodem bot dostaje pustą stronę.
Powtórka zmieniła w metodzie jedną rzecz, bo za pierwszym razem pobierałem strony jako desktopowy Chrome, a za drugim jako mój robot badawczy. Werdykt zmienił się tylko u trzech serwisów, więc w tej próbie wynik się trzyma.
React SEO: renderowanie w przeglądarce traci więcej niż renderowanie na serwerze
Problemy z React SEO biorą się z renderowania po stronie klienta, a Vue i Angular mają ten sam kłopot. W mojej próbie ponad połowa serwisów na czystym Reakcie, Vue albo Angularze traciła bez JavaScriptu ważną treść. Na Next.js, Nuxt, SvelteKit i Gatsbym, które domyślnie renderują na serwerze, było to mniej niż trzy na dziesięć.
Na meta-frameworku też da się to zepsuć. Sam Next.js nie wypadł lepiej niż cała próba, bo ważną treść traciła ponad jedna trzecia jego stron głównych. Kilka było pustą skorupą, bo ładowały treść w przeglądarce.
Średnią grupy renderującej na serwerze poprawia głównie Nuxt. Framework daje ci renderowanie na serwerze, ale każda ścieżka musi z niego skorzystać.
Pięć typowych przyczyn problemów z JavaScript SEO
Większość luk, które widziałem, wyjaśnia kilka powtarzalnych wzorców, a każdy z nich rozpoznasz w HTML-u z serwera.
- Dane pobierane po załadowaniu strony. Komponent, który woła API w
useEffect(React) alboonMounted(Vue), wysyła z serwera pusty kontener i wypełnia go dopiero w przeglądarce. Szukaj nagłówka bez akapitu pod spodem albo pustego<ul>. - Metadane ustawiane przez bibliotekę działającą tylko w przeglądarce. W czystej aplikacji SPA tytuł i canonical wpisuje skrypt, więc HTML z serwera ma domyślne wartości z
index.html. Jeśli kilka różnych ścieżek zwraca wcurlten sam tytuł, to twoja przyczyna. - Nawigacja bez prawdziwych linków. Menu z elementów
<div>albo<button>z obsługą kliknięcia wygląda dla człowieka tak samo, a robotowi nie daje niczego, za czym mógłby pójść, bo bot nie klika, tylko idzie za adresem zhref. - Treść za przyciskiem „Pokaż więcej” albo w nieskończonym przewijaniu. Produkty i starsze wpisy, które dochodzą dopiero przy przewijaniu lub po kliknięciu, nie trafiają do HTML-u z serwera, więc daj każdej stronie wyników własny adres, np.
?page=2. - Zapora, która blokuje roboty AI. To nie jest problem JavaScriptu, ale skutek wygląda tak samo, czyli pusta strona. Vercel i Cloudflare mają w swoich zaporach gotowe ustawienia do blokowania znanych botów AI, więc zapytaj osobę, która zarządza twoją, jak jest ustawiona.
Przy linkach różnica w kodzie jest drobna, a dla robota zasadnicza:
<!-- Za tym robot nie pójdzie -->
<div class="nav-item" onclick="router.push('/cennik')">Cennik</div>
<!-- Za tym pójdzie, a router dalej obsłuży kliknięcie -->
<a href="/cennik">Cennik</a>
Jak sprawdzić JavaScript SEO na swojej stronie
Najszybsze sprawdzenie JavaScript SEO zajmuje kilka minut i nie wymaga płatnych narzędzi, a ja robię te kroki po kolei.
- Pobierz HTML z serwera. Uruchom
curl -sL -A "Mozilla/5.0" https://twojastrona.pl/ > strona.html, policz nagłówki H1 poleceniemgrep -o "<h1" strona.html | wc -l, a potem poszukaj w pliku zdania z głównej treści. Jeśli go tam nie ma, robot bez JavaScriptu też go nie zobaczy, a jeśli dostałeś stronę testu na bota, w imieniu strony odpowiada twoja zapora. - Porównaj „Wyświetl źródło” z „Zbadaj”. Źródło pokazuje HTML z serwera, a panel Elementy (Elements) wyrenderowany DOM. Wszystko, co jest tylko w drugim, zależy od JavaScriptu.
- Wyłącz JavaScript. W Chrome DevTools naciśnij Ctrl+Shift+P (Cmd+Shift+P na Macu), wpisz „Disable JavaScript” i odśwież stronę. To, co zostanie, to mniej więcej to, co czyta robot AI.
- Sprawdź, co mogą pobrać roboty AI. Nasz darmowy AI visibility checker pobiera jedną stronę tak jak robot AI, z pominięciem JavaScriptu, pokazuje, ile słów głównej treści jest w HTML-u z serwera, i sprawdza twój robots.txt dla 14 robotów.
- Sprawdź, co wyrenderował Google. W Search Console otwórz Sprawdzanie adresu URL > Sprawdź URL na żywo > Wyświetl sprawdzoną stronę > HTML. To wersja, którą wyrenderował Google.
Krok 1 zrób dla jednego adresu z każdego szablonu, bo strona główna bywa statyczna, a problem zaczyna się na kartach produktów albo we wpisach. Ta pętla wypisuje, ile linków każdy szablon wysyła przed JavaScriptem:
for u in / /cennik /blog/twoj-najlepszy-wpis /produkty/twoj-najlepszy-produkt; do
printf "%s " "$u"; curl -sL -A "Mozilla/5.0" "https://twojastrona.pl$u" | grep -o "<a [^>]*href" | wc -l
done
To samo porównanie zrobiłem dla cometweb.io, który stoi na SvelteKit. HTML strony głównej z serwera ma każdy ważny znacznik i każdy link wewnętrzny. Około jednej piątej tekstu pojawia się dopiero po JavaScripcie i cała ta część pochodzi z interaktywnego demo Insight oraz banera cookies.
SEO dla aplikacji jednostronicowych (SPA): jak to naprawić
SEO dla aplikacji jednostronicowych naprawia się na serwerze, bo kolejne łatki w kodzie przeglądarki tylko przesuwają problem. Każda strona, którą chcesz mieć w indeksie albo w odpowiedziach AI, powinna wyjść z serwera z treścią i linkami już w HTML-u, a ja pracowałbym w takiej kolejności.
- Renderuj na serwerze ścieżki do indeksowania. Użyj SSR albo generowania statycznego dla każdej strony, która ma rankować, od kart produktów po artykuły. Next.js i Nuxt robią to domyślnie, a Angular ma własny pakiet SSR. Czysta aplikacja SPA w React albo Vue zwykle wymaga przejścia na Next.js lub Nuxt albo przynajmniej prerenderingu publicznych stron przy budowaniu.
- Wstaw metadane do szablonu serwera. Tytuł, opis i canonical należą do pierwszej odpowiedzi HTML. Google przeczyta canonical ustawiony JavaScriptem, ale jego dokumentacja prosi, żeby JavaScript nie zmieniał tego z oryginalnego HTML-u. Jeśli piszesz blok head ręcznie, dobrym punktem wyjścia jest generator meta tagów.
- Używaj prawdziwych linków. Każdy element nawigacji i paginacji powinien być linkiem
<a>z prawdziwą ścieżką whref, na przykład/produkty, i routingiem przez History API. Obsługa kliknięć i fragmenty#/produktynie dają robotom niczego, za czym mogłyby pójść, dlatego mój audyt linkowania wewnętrznego zaczyna się od linków, które robot widzi w źródle. - Zwracaj uczciwe kody odpowiedzi. Brakujący produkt w SPA często zwraca 200 i szkielet aplikacji, a tekst „nie znaleziono” pokazuje dopiero skrypt. Google traktuje to jako soft 404, więc najlepiej, żeby serwer od razu zwracał 404 albo 410. W czystej aplikacji SPA Google proponuje przekierowanie JavaScriptem na adres, który zwraca 404, albo znacznik
noindexdodany JavaScriptem.
SSR, SSG, ISR czy CSR: którą strategię renderowania wybrać
Większość problemów z JavaScript SEO to w praktyce zły sposób renderowania dla danego typu strony. Jedna aplikacja może łączyć kilka metod, więc decyduj osobno dla każdego szablonu.
| Strategia | Co dostaje robot w pierwszym HTML-u | Kiedy pasuje | Na co uważać |
|---|---|---|---|
| SSG (generowanie statyczne) | Całą treść | Blog, dokumentacja, landingi | Po zmianie treści trzeba przebudować stronę |
| ISR (statyczne z odświeżaniem) | Całą treść | Katalog produktów, duże serwisy z treścią | Treść bywa przez chwilę nieaktualna |
| SSR (renderowanie na serwerze) | Całą treść | Strony zależne od danych na żywo | Koszt serwera i czas pierwszej odpowiedzi (TTFB) |
| CSR (tylko w przeglądarce) | Pusty szkielet | Panel po zalogowaniu, narzędzia wewnętrzne | Nie dla stron, które mają być w Google i w AI |
Osobna, wyrenderowana kopia tylko dla botów była kiedyś standardowym obejściem. Dziś Google nazywa renderowanie dynamiczne obejściem, którego nie zaleca, więc w nowym projekcie bym go nie wdrażał, a w starym traktowałbym je jako most do SSR albo SSG. Moja reguła na start jest prosta. Wszystko, co ma się pojawić w wynikach wyszukiwania albo w odpowiedziach AI, trafia do HTML-u z serwera, a JavaScript tylko tę stronę ulepsza.
Jak wytłumaczyć JavaScript SEO klientowi albo programiście
Najprościej wytłumaczyć JavaScript SEO, pokazując obie wersje tej samej strony obok siebie. Połóż wynik curl obok strony w przeglądarce i zaznacz H1 w obu, a kiedy po lewej go brakuje, wykład o kolejkach renderowania nikomu nie jest potrzebny.
Programiście nie mówię, że „SEO jest zepsute”, tylko zadaję trzy pytania:
- Które ścieżki renderują się na serwerze, a które tylko w przeglądarce?
- Gdzie ustawiasz tytuł i canonical, w szablonie serwera czy w kodzie uruchamianym w przeglądarce?
- Czy menu i karty produktów składają się z linków
<a href>, czy z obsługi kliknięć?
Najczęściej usłyszysz, że „Google i tak renderuje JavaScript”. Renderuje, ale później i tylko u siebie, a asystenci, z których korzystają twoi klienci, czytają HTML z serwera.
Sprawdź poprawki JavaScript SEO audytem
Renderowanie to jeden punkt szerszego przeglądu, który opisałem w tekście o technicznym SEO, więc kiedy ważne szablony zwracają już pełny HTML z serwera, sprawdź też resztę. CometWeb Insight to nasza aplikacja do audytu stron. Jeden audyt obejmuje w niej wydajność (Core Web Vitals), techniczne SEO, dostępność (WCAG), bezpieczeństwo i szacunkowy ślad węglowy, a wynik dostajesz jako zadania ułożone według priorytetu.
Po wdrożeniu SSR uruchamiasz audyt jeszcze raz i porównujesz wyniki przed i po, co ma tu znaczenie, bo przejście na renderowanie po stronie serwera zwykle zmienia też czasy ładowania. Możesz założyć darmowe konto i puścić pierwszy audyt jeszcze dziś.
JavaScript SEO na koniec
Diagnoza zajmuje jeden curl i jedno wyszukanie H1. Naprawa trwa dłużej, bo przejście aplikacji renderowanej w przeglądarce na SSR dotyka routingu i pobierania danych.
Nie musisz jednak przerabiać wszystkiego naraz. Zacznij od sprawdzenia curl na stronie głównej, najlepiej sprzedającym się produkcie i najczęściej czytanym artykule. Jeśli któraś z nich wróci bez głównego tekstu, renderowanie tego szablonu na serwerze wstaw na początek następnego sprintu.
Najczęstsze pytania
Czy Next.js jest domyślnie przyjazny dla SEO?
Tak, Next.js domyślnie renderuje strony na serwerze, a komponenty oznaczone 'use client' też trafiają do HTML-u przy pierwszym ładowaniu. Kłopot zaczyna się, kiedy dane pobierasz dopiero w przeglądarce, np. w useEffect, bo wtedy serwer wysyła sam szkielet ładowania. Dlatego każdy ważny szablon sprawdź curl-em także w Next.js.
Czy aplikacja za logowaniem potrzebuje renderowania po stronie serwera?
Aplikacja za logowaniem nie potrzebuje renderowania po stronie serwera ze względu na SEO, bo wyszukiwarki i roboty AI i tak nie mają do niej dostępu. Na serwerze renderuj części publiczne, od strony głównej i dokumentacji po strony logowania i rejestracji.
Czy zablokowanie GPTBot ukrywa stronę przed wyszukiwaniem w ChatGPT?
OpenAI ma osobne roboty do trenowania modeli i do wyszukiwania, więc reguła w robots.txt tylko dla GPTBot zostawia OAI-SearchBot wolną drogę do twoich stron i strona dalej może pojawiać się w wynikach ChatGPT. Zanim zdecydujesz, co dopuścić, sprawdź, które user agenty naprawdę blokuje twój robots.txt i zapora.
Czy Google widzi treść ładowaną przez JavaScript?
Zwykle tak, ale z opóźnieniem, po przejściu przez kolejkę renderowania. Linki dodane przez skrypt Google odkrywa później, a błąd skryptu albo zablokowany plik może sprawić, że część treści w ogóle nie trafi do indeksu.
Czy renderowanie dynamiczne to dobre rozwiązanie?
Google nazywa renderowanie dynamiczne obejściem. Działa, ale utrzymujesz dwie wersje strony i ryzykujesz, że ich treść się rozjedzie, więc jeśli możesz, przejdź na SSR albo SSG dla stron, które mają być w Google.
Źródła
- Google Search Central: Podstawy JavaScript SEO. Skanowanie, kolejka renderowania, linki, canonical i soft 404 w aplikacjach jednostronicowych.
- Google Search Central: Linki, które Google może zindeksować. Wymagania dla elementów
<a>i atrybutuhref. - Google Search Central: Renderowanie dynamiczne jako obejście. Dlaczego Google już go nie zaleca.
- Google Search Central: Rozwiązywanie problemów z JavaScriptem w wyszukiwarce. Debugowanie wyrenderowanych stron i unikanie soft 404.
- Vercel: The rise of the AI crawler. Które roboty AI pobierają i renderują JavaScript, na danych o ruchu z Vercela i MERJ.
- Resoneo: AI Search crawler test results. Co czytają asystenci, kiedy użytkownik każe im otworzyć stronę.
- OpenAI: Overview of OpenAI crawlers. GPTBot, OAI-SearchBot i ChatGPT-User oraz do czego służy każdy z nich.
- web.dev: Rendering on the web. Porównanie SSR, generowania statycznego, CSR i hydratacji.
- CometWeb: HTML z serwera a wyrenderowana strona na serwisach na frameworkach JavaScript. Oba pomiary, skrypty i dane.
Ujawnienie: CometWeb Insight i darmowe narzędzia z /pl/tools to produkty CometWeb, wydawcy tego bloga.