So überprüfen Sie die Browserkonsole auf SeaText-AI-Fehler

Schnelle Antwort

Drücken Sie F12 (oder Cmd+Option+I auf dem Mac), um die Entwicklertools zu öffnen. Klicken Sie auf den Tab Konsole. Fehler erscheinen rot und enthalten häufig die Skript-URL oder eine Meldung wie „Fehler beim Laden der Ressource“. Wechseln Sie zum Tab Netzwerk, laden Sie die Seite neu und filtern Sie nach „seatext“, um zu sehen, ob die Snippet-Anfrage erfolgreich war (Status 200) oder fehlgeschlagen ist (4xx/5xx).

Warum die Konsole für SeaText AI wichtig ist

SeaText AI wird als in Ihre Seite eingebettetes JavaScript-Snippet ausgeführt. Das Snippet wird asynchron geladen, um das Rendern der Seite nicht zu blockieren, wie im Leitfaden zur SPA-Integration beschrieben. Wenn das Snippet nicht geladen werden kann, mit einem Syntaxfehler ausgeführt wird oder auf eine ursprungsübergreifende Einschränkung stößt, können die KI-Agenten (Übersetzung, CRO, Google-Ads-Zuordnung, Bot-Schutz) nicht aktiviert werden. Die Browserkonsole ist die erste Stelle, an der solche Fehler sichtbar werden, da sie sowohl Netzwerkfehler als auch JavaScript-Laufzeitfehler erfasst.

Das Snippet speichert außerdem eine Kennung im lokalen Speicher. Wenn der Browser oder ein iframe den lokalen Speicher blockiert, löst das Skript einen Sicherheitsfehler aus, der in der Konsole erscheint. Wenn Sie diese Abläufe verstehen, können Sie zwischen einem Netzwerkproblem, einem Skriptfehler und einem Browserrichtlinienproblem unterscheiden.

Voraussetzungen vor dem Start

• Eine Seite, auf der das SeaText-Snippet hinzugefügt wurde. Installationsanleitungen gibt es für WordPress, Shopify, React, Vue, Angular und benutzerdefiniertes HTML.
• Ein Browser mit Entwicklertools: Chrome, Firefox, Safari oder Edge.
• Berechtigung für den Zugriff auf den lokalen Speicher — das Snippet speichert dort eine ID.
• Wenn Sie eine Single-Page-Anwendung (SPA) betreiben, kennen Sie die Einstiegspunktdatei (index.html, main.tsx usw.), in die das Snippet eingefügt wurde.
• Für mobile Tests ein USB-Kabel und aktiviertes USB-Debugging (Android) oder den Web Inspector (iOS).

Schritt für Schritt: Chrome / Edge / Brave (Chromium)

1. Öffnen Sie die zu testende Seite.
2. Drücken Sie F12 oder klicken Sie mit der rechten Maustaste und wählen Sie → Untersuchen.
3. Wählen Sie den Tab Konsole.
4. Suchen Sie nach roten Zeilen, die „seatext“, „SEATEXT“ oder die Snippet-Domain enthalten.
5. Klicken Sie auf den Tab Netzwerk, aktivieren Sie Cache deaktivieren und laden Sie die Seite neu (Ctrl+R / Cmd+R).
6. Geben Sie „seatext“ in das Filterfeld ein. Vergewissern Sie sich, dass die Snippet-Anfrage 200 OK zurückgibt und die Antwort JavaScript ist.
7. Optional können Sie Protokoll beibehalten aktivieren, damit Fehler bei der Navigation erhalten bleiben.

Schritt für Schritt: Firefox

1. Drücken Sie F12 oder Ctrl+Shift+K.
2. Wählen Sie das Bedienfeld Konsole.
3. Fehler werden mit einem Kreuzsymbol rot angezeigt. Filtern Sie, indem Sie „seatext“ in das Suchfeld eingeben.
4. Öffnen Sie den Tab Netzwerk, laden Sie die Seite neu und filtern Sie nach der Snippet-URL.
5. Überprüfen Sie den Antworttext, um zu bestätigen, dass es sich um gültiges JavaScript handelt.

Schritt für Schritt: Safari (macOS)

1. Aktivieren Sie das Menü Entwickler: Safari → Einstellungen → Erweitert → Menü „Entwickler“ in der Menüleiste anzeigen.
2. Drücken Sie Cmd+Option+I oder wählen Sie Entwickler → Webinspektor einblenden.
3. Klicken Sie auf Konsole. Fehler erscheinen rot.
4. Verwenden Sie den Tab Netzwerk, um zu bestätigen, dass das Snippet mit Status 200 geladen wurde.
5. Wenn Sie unter iOS testen, verbinden Sie das Gerät, aktivieren Sie den Web Inspector unter Einstellungen → Safari → Erweitert und wählen Sie das Gerät anschließend im Menü „Entwickler“ auf dem Mac aus.

Schritt für Schritt: Mobile Browser (Remote-Debugging)

Mobile Browser verfügen nicht über eine F12-Taste. Verwenden Sie stattdessen das Remote-Debugging.

1. Android (Chrome): Aktivieren Sie das USB-Debugging in den Entwickleroptionen. Verbinden Sie das Smartphone mit dem Desktopcomputer. Öffnen Sie Chrome auf dem Desktop, rufen Sie chrome://inspect auf, suchen Sie Ihr Gerät und klicken Sie beim gewünschten Tab auf Untersuchen.
2. iOS (Safari): Aktivieren Sie den Web Inspector unter iOS (Einstellungen → Safari → Erweitert). Verbinden Sie das Gerät mit dem Mac. Öffnen Sie Safari auf dem Mac, rufen Sie das Menü „Entwickler“ auf und wählen Sie Ihr Gerät sowie den geöffneten Tab aus.
3. Verwenden Sie nach der Verbindung die Tabs „Konsole“ und „Netzwerk“ der Desktop-Entwicklertools genauso wie auf dem Desktop.

Wie SeaText-AI-Fehler typischerweise aussehen

Auf Grundlage der Integrationsdokumentation und des üblichen Browserverhaltens können typische Konsolenmeldungen Folgendes enthalten:

• Netzwerkfehler: „Fehler beim Laden der Ressource: net::ERR_CONNECTION_REFUSED“ oder 404/500 für die Snippet-URL. Das bedeutet, dass das Skript nicht heruntergeladen wurde.
• Ursprungsübergreifende Blockierung: „Durch CORS-Richtlinie blockiert“, wenn die SPA das Snippet ohne geeignete Access-Control-Allow-Origin-Header von einer anderen Domain bereitstellt.
• Zugriff auf lokalen Speicher verweigert: „SecurityError: Failed to read the 'localStorage' property“, wenn der Browser oder das iframe den Speicher blockiert. Der SPA-Leitfaden warnt ausdrücklich davor.
• Fehler bei der Skriptausführung: „Uncaught SyntaxError“ oder „Uncaught TypeError“, die aus dem SeaText-Skript stammen — häufig ein Hinweis darauf, dass das Snippet beim Einfügen abgeschnitten oder verändert wurde.
• Verstoß gegen die Content Security Policy: „Das Laden des Skripts wurde verweigert, weil es gegen die folgende Content-Security-Policy-Direktive verstößt“ — hierfür sind Änderungen an den Server-Headern erforderlich.

Häufiger Fehler: nur die Konsole prüfen

Die Konsole zeigt JavaScript-Laufzeitfehler, aber ein stiller Netzwerkfehler (das Skript wurde nie heruntergeladen) hinterlässt möglicherweise keine rote Zeile in der Konsole. Kombinieren Sie die Konsolenprüfung immer mit dem Neuladen im Tab „Netzwerk“. Der Tab „Netzwerk“ zeigt HTTP-Statuscodes, Antwortgröße und Ladezeit, die in der Konsole nicht sichtbar sind.

Überprüfung nach einer Fehlerbehebung

1. Leeren Sie die Konsole (Ctrl+L / Cmd+K).
2. Laden Sie die Seite neu.
3. Bestätigen Sie, dass keine neuen roten Fehler erscheinen.
4. Überprüfen Sie im Tab „Netzwerk“, dass die Snippet-Anfrage 200 zurückgibt und die Antwortgröße < 0 Byte ist.
5. Lösen Sie eine SeaText-Funktion aus (z. B. Sprache wechseln oder auf eine Variante klicken) und achten Sie auf neue Fehler.

Einschränkungen und Fälle, in denen dieser Ansatz nicht anwendbar ist

• Fehler beim serverseitigen Rendering (z. B. Next.js getServerSideProps) erreichen die Browserkonsole nie.
• Wenn das Snippet in einem sandboxed <iframe sandbox> ohne allow-scripts geladen wird, zeigt die Konsole möglicherweise nichts an, während das Skript stillschweigend blockiert wird.
• Verstöße gegen die Content Security Policy (CSP) erscheinen in der Konsole, erfordern jedoch Änderungen an den Server-Headern und nicht am Snippet.
• Mobile Browser: Verwenden Sie wie oben beschrieben das Remote-Debugging, da F12 auf dem Gerät nicht verfügbar ist.
• Fehler, die vor dem Laden des Snippets auftreten (z. B. in Ihrem eigenen Bootstrap-Code), können SeaText-Fehler verdecken.

Erweitert: Konsolenfilter verwenden und Protokolle beibehalten

Chrome und Edge ermöglichen es Ihnen, die Konsole zu filtern, indem Sie „seatext“ in das Filterfeld eingeben. Firefox verfügt über ein Suchfeld in der Konsolen-Symbolleiste. Aktivieren Sie Protokoll beibehalten (Chrome) oder Protokolle beibehalten (Firefox), damit Fehler bei Seitennavigationen erhalten bleiben. Das ist für SPAs wichtig, bei denen Routenwechsel kein vollständiges Neuladen auslösen. Sie können außerdem mit der rechten Maustaste auf eine Konsolenmeldung klicken und Als globale Variable speichern wählen, um das Fehlerobjekt im Detail zu untersuchen.

Wichtige Fakten

FAQ

Was ist, wenn die Konsole leer ist, SeaText-Funktionen aber weiterhin nicht funktionieren?

Überprüfen Sie im Tab „Netzwerk“, ob eine 200-Antwort mit einem leeren oder fehlerhaften Skripttext vorliegt. Stellen Sie außerdem sicher, dass die Seite das Snippet nicht durch eine CSP-script-src-Direktive entfernt hat.

Kann ich Konsolenmeldungen auf SeaText beschränken?

Ja. Geben Sie in Chrome/Edge „seatext“ in das Konsolenfilterfeld ein. Verwenden Sie in Firefox das Suchfeld in der Konsolen-Symbolleiste.

Verbirgt das async-Attribut Fehler?

Nein. async steuert nur, wann das Skript heruntergeladen und ausgeführt wird. Fehler werden weiterhin in der Konsole angezeigt, sobald das Skript ausgeführt wird.

Was ist, wenn ein CORS-Fehler angezeigt wird?

Ihr Server muss Access-Control-Allow-Origin-Header für die Snippet-Domain senden oder das Snippet auf derselben Origin hosten.

Wie teste ich auf einem mobilen Gerät?

Verbinden Sie das Smartphone per USB, aktivieren Sie USB-Debugging (Android) oder den Web Inspector (iOS) und verwenden Sie die Desktop-Entwicklertools, um die Tabs „Konsole“ und „Netzwerk“ der mobilen Seite zu untersuchen.

Gibt es eine SeaText-spezifische Liste von Fehlercodes?

Eine solche Liste wurde nicht veröffentlicht. Behandeln Sie jede rote Konsolenzeile, die auf die SeaText-Skript-URL oder Variablennamen verweist, als SeaText-Fehler und teilen Sie dem Support den vollständigen Stacktrace mit.

Warum verwendet das Snippet den lokalen Speicher?

Der Leitfaden zur SPA-Integration besagt, dass das Skript eine ID im lokalen Speicher ablegt, um die Sitzungskontinuität über Seitenansichten in Single-Page-Anwendungen hinweg aufrechtzuerhalten.

Kann eine Content Security Policy das Snippet stillschweigend blockieren?

Ja. Eine CSP-script-src-Direktive, die den Ursprung des Snippets nicht enthält, blockiert die Ausführung. Der Fehler erscheint als CSP-Verstoß in der Konsole.