JavaScript-SEO ist die Aufgabe, dafür zu sorgen, dass Websites, die Inhalte oder Links mit JavaScript erzeugen, von Suchmaschinen korrekt gecrawlt, ausgeführt und indexiert werden. Auf einer Website, die mit Frameworks wie React, Vue oder Angular gebaut ist, kann im Browser alles einwandfrei aussehen; Googlebot verarbeitet dieselbe Seite aber unter anderen Bedingungen und in zwei Phasen. Deshalb reicht „bei mir funktioniert es“ nicht aus. In diesem Beitrag behandeln wir, wie Google JavaScript verarbeitet, welche Architektur welche Risiken birgt und worauf Sie in der Praxis achten sollten.
Was ist JavaScript-SEO?
Auf einer klassischen Webseite sendet der Server den Inhalt direkt als HTML. Bei JavaScript-lastigen Websites sendet der Server dagegen meist ein leeres Grundgerüst und ein Skript-Paket; der eigentliche Inhalt entsteht im Browser, nachdem das Skript ausgeführt wurde. Aus Sicht der Suchmaschine stellt sich dann die Frage: Kann der Bot das Skript ausführen und den endgültigen Inhalt sehen, wann, und wie zuverlässig?
Google kann JavaScript heute ausführen; das Problem ist, dass diese Fähigkeit nicht bedingungslos und ohne Verzögerung greift. Die folgenden Abschnitte zeigen, wo sich der Unterschied bemerkbar macht.
Wie verarbeitet Google JavaScript?
In der Dokumentation von Google wird der Ablauf in drei Schritten beschrieben:
- Crawling: Googlebot ruft die Adresse ab, erhält die HTML-Antwort und prüft die Regeln in
robots.txt. - Rendering: Die Seite wird mit einer aktuellen Chromium-Version ausgeführt, und der von JavaScript erzeugte endgültige Inhalt wird sichtbar. Dieser Schritt wird eingereiht, kann also nicht sofort erfolgen.
- Indexierung: Text und Links der gerenderten Seite werden in den Index aufgenommen; neue Links kommen in die Crawl-Reihenfolge.
Praktisch heißt das: Alles, was im ersten HTML steht, wird am frühesten und zuverlässigsten erfasst. Was nur durch JavaScript hinzugefügt wird, wartet in der Rendering-Warteschlange und trägt ein zusätzliches Risiko; schlägt das Skript fehl, läuft in ein Timeout oder ist blockiert, wird der Inhalt unter Umständen nie gesehen.
Wichtig: Suchmaschinen außer Google und einige KI-Bots führen JavaScript unter Umständen nicht so gut aus wie Google. Den kritischen Inhalt Ihrer Website im ersten HTML bereitzustellen, ist auch für diese Bots der sicherste Weg.
CSR, SSR und statische Generierung
| Methode | Funktionsweise | Im Hinblick auf SEO |
|---|---|---|
| CSR (clientseitig) | Der Browser erhält ein leeres Grundgerüst, der Inhalt wird vom Skript erzeugt | Die riskanteste Option; der Inhalt hängt vom Rendering ab |
| SSR (serverseitig) | Der Server erzeugt bei jeder Anfrage vollständiges HTML, danach übernimmt das Skript im Browser | Der Inhalt kommt in der ersten Antwort; eine starke Wahl für die meisten inhaltsorientierten Websites |
| SSG (statische Generierung) | Seiten werden vor der Veröffentlichung als HTML erzeugt | Schnell und zuverlässig; ideal für Inhalte, die sich selten ändern |
| Hybrid | Je nach Seite eine Mischung aus SSR, SSG oder CSR | Gängiger Ansatz moderner Frameworks; kritische Seiten sollten SSR oder SSG nutzen |
Das früher empfohlene „dynamische Rendering“ (Bots eine separate HTML-Version ausliefern) empfiehlt Google nicht mehr als dauerhafte Lösung; es wird als Übergangslösung beschrieben. Wenn Sie ein neues Projekt aufsetzen, senkt die Wahl von SSR oder SSG auch den Wartungsaufwand. Welche Optionen Ihr Framework (z. B. Next.js, Nuxt, Astro) bietet, entnehmen Sie dessen eigener Dokumentation.
Die häufigsten JavaScript-SEO-Probleme
- Kritischer Inhalt kommt nur über JS: Fehlen Titel, Produktbeschreibung, Preis oder Haupttext im ersten HTML, besteht ein Risiko.
- JS- und CSS-Dateien sind per robots.txt gesperrt: Der Bot kann die Seite dann nicht korrekt rendern. Sperren Sie wichtige Skripte nicht; die Regeln dazu erklärt unser robots.txt-Leitfaden.
- Navigation ohne echte Links: Elemente, die nur über ein Klickereignis funktionieren, sind keine crawlbaren Links.
- Inhalte, die beim Scrollen oder Klicken geladen werden: Googlebot scrollt nicht und klickt nicht; Inhalte hinter einer Schaltfläche „Mehr anzeigen“ bleiben unter Umständen unsichtbar.
- Adressen mit Hash (#): Eine Fragmentkennung wie
#/produktegilt nicht als eigene Seite. - Zu spät oder fehlerhaft geladener Inhalt: Sehr langsame API-Antworten, Zeitüberschreitungen oder Skriptfehler lassen den Inhalt beim Rendering leer.
- Fehlerhafte Verwaltung der Meta-Tags: Title, Description und canonical werden nicht für jede Seite korrekt erzeugt.
Links und URL-Struktur
Für die Linkerkennung prüft Google das Attribut href des Elements <a>. Die beiden folgenden
Beispiele sehen gleich aus, aber nur das erste ist crawlbar:
<!-- Crawlbar -->
<a href="https://hitbot.org/urunler/ayakkabi">Schuhe</a>
<!-- Nicht crawlbar: kein href, nur Ereignis-Listener -->
<span onclick="git('/urunler/ayakkabi')">Schuhe</span>
Bei Single-Page-Anwendungen (SPA) sollten Sie beim Wechsel zwischen Seiten die History API des Browsers nutzen und für jede Ansicht eine echte und eindeutige Adresse erzeugen. Jede Adresse muss auch beim direkten Aufruf (Neuladen oder geteilter Link) denselben Inhalt liefern. Die allgemeine Logik interner Links behandelt unser Beitrag zur Strategie der internen Verlinkung.
Statuscodes, noindex und canonical
Am häufigsten übersehen wird in JavaScript-Anwendungen dieser Bereich:
- Fehlerseiten: Eine nicht vorhandene Adresse kann in einer SPA die Meldung „Seite nicht gefunden“ anzeigen und trotzdem HTTP 200 liefern. Das ist ein Soft 404. Sorgen Sie dafür, dass der Server einen echten 404 zurückgibt, oder setzen Sie in der Fehleransicht noindex. Details finden Sie in unserem Beitrag 404-Fehler und SEO.
- Noindex und JavaScript: Ist im ursprünglichen HTML ein
noindexvorhanden, kann Google das Rendern der Seite überspringen; dann bringt es nichts, es per JavaScript entfernen zu wollen. Auf Seiten, die indexiert werden sollen, darf im ersten HTML kein noindex stehen. - Canonical: Setzen Sie es möglichst schon im ersten HTML. Es kann auch per JavaScript eingefügt werden, aber zwei widersprüchliche canonical-Angaben (eine im HTML, eine per Skript) verwirren Google. Zur Logik von canonical lesen Sie unseren canonical-Leitfaden.
- Weiterleitungen: Bevorzugen Sie serverseitige HTTP-Weiterleitungen gegenüber JavaScript-Weiterleitungen; die Unterschiede zwischen 301 und 302 erklären wir in unserem Beitrag zu 301 und 302.
Testen, was Google sieht
- Quelltexte vergleichen: Vergleichen Sie im Browser die Ansicht „Seitenquelltext anzeigen“ (rohes HTML) mit der Elements-Ansicht der Entwicklerwerkzeuge (gerendertes DOM). Ist der Haupttext nur in der zweiten Ansicht vorhanden, ist der Inhalt von JS abhängig.
- URL-Prüfung: Prüfen Sie die Adresse in der Search Console, wählen Sie „Live-Test“ und sehen Sie sich über „Getestete Seite anzeigen“ das von Google gerenderte HTML und den Screenshot an.
- Test ohne JavaScript: Schalten Sie im Browser JavaScript aus und öffnen Sie die Seite. Ist nichts zu sehen, sieht der Bot in der ersten Phase ebenfalls nichts.
- Nicht ladbare Ressourcen: Prüfen Sie in der URL-Prüfung, ob Skripte oder API-Aufrufe blockiert sind oder nicht geladen werden konnten.
- Indexkontrolle: Suchen Sie einen Satz der Seite in Anführungszeichen zusammen mit
site:ihredomain.de, um zu sehen, ob der Inhalt im Index ist.
Wenn Seiten gar nicht im Index erscheinen, können Sie die Ursache eingrenzen, indem Sie die Statusangaben im Bericht der Search Console mit unserem Leitfaden zu Indexierungsproblemen abgleichen.
Checkliste vor der Veröffentlichung
Arbeiten Sie mit einem Entwicklungsteam, lassen Sie die folgenden Punkte vor jeder wichtigen Veröffentlichung als „ja / nein“ abhaken:
- Sind Titel, Haupttext und Hauptbild einer Seite in der ersten HTML-Antwort enthalten?
- Hat jede Seite einen eindeutigen Title, eine Description und ein canonical-Tag, das auf die eigene Adresse zeigt?
- Sind Menü- und Paginierungslinks echte
<a href>-Elemente? - Liefern nicht vorhandene Adressen einen echten 404?
- Sind wichtige JS- und CSS-Dateien nicht per robots.txt gesperrt?
- Zeigt die Seite bei deaktiviertem JavaScript zumindest den Haupttext an?
- Bleibt die Seite bei Skriptfehlern oder einer langsamen API leer, oder zeigt sie einen sinnvollen Ersatzinhalt?
- Gelangt eine neue Ansicht (Route) bei ihrer Erstellung in die Sitemap?
Diese Liste hilft bei einer neuen Website ebenso wie bei der Erneuerung von Design oder Infrastruktur einer bestehenden Website. Teilt die SEO-Verantwortliche die Liste zu Beginn der Entwicklung, sinken die Korrekturkosten stark; denn sobald die Architektur festgelegt ist, ist eine Änderung der Rendering-Methode die teuerste Maßnahme.
Performance und JavaScript
Schwere JavaScript-Pakete belasten nicht nur den Bot, sondern auch die Nutzer. Große Skripte können die Interaktionsverzögerung (INP) und die Ladezeit (LCP) verschlechtern. Code-Splitting, das Entfernen ungenutzten Codes, die Begrenzung von Drittanbieter-Skripten und das Verzögern unkritischer Skripte sind grundlegende Schritte. Zu den Kennzahlen lesen Sie unseren Core-Web-Vitals-Leitfaden, zu allgemeinen Geschwindigkeitsmaßnahmen unseren Beitrag zu Methoden zur Steigerung der Seitengeschwindigkeit. Die offizielle Darstellung von Google finden Sie in den Grundlagen zu JavaScript-SEO.
Häufig gestellte Fragen
Versteht Google JavaScript vollständig?
Zum großen Teil führt Google es aus, allerdings bedeutet das Rendering eine zusätzliche Warteschlange und Verzögerung. Den kritischen Inhalt im ersten HTML auszuliefern, ist der sicherste Weg.
Sind React oder Vue schlecht für SEO?
Nein. Das Problem ist nicht das Framework, sondern die Art, wie der Inhalt ausgeliefert wird. Mit SSR oder statischer Generierung ist auch mit diesen Frameworks gesundes SEO möglich.
Sollte ich dynamisches Rendering verwenden?
Google empfiehlt es nicht als langfristige Lösung. Bei neuen Projekten sind SSR oder SSG die richtigere Wahl.
Schadet Lazy Loading dem SEO?
Nicht, wenn es richtig umgesetzt wird. Nutzen Sie das native Laden des Browsers und verlangen Sie für das Auslösen von Inhalten keine Nutzerinteraktion; Googlebot klickt und scrollt nicht.
Fazit
Das Wesentliche bei JavaScript-SEO ist: Alles, was Google sehen soll, muss für den Bot zugänglich sein, sobald er die Seite abruft. Liefern Sie den Inhalt im ersten HTML, verwenden Sie echte Links und echte Adressen, geben Sie die richtigen Statuscodes zurück, sperren Sie wichtige Skripte nicht und prüfen Sie die gerenderte Seite regelmäßig mit der URL-Prüfung. Wenn Sie diese Gewohnheiten in Ihre Checkliste für technisches SEO aufnehmen, werden die meisten Probleme schon vor der Veröffentlichung erkannt.