JavaScript funktioniert lokal nicht: was Sie prüfen sollten

JavaScript kann eine lokale Vorschau verbessern, aber auch dafür sorgen, dass eine Seite anders wirkt als auf dem Live-Server.

Das Problem

Moderne Projekte nutzen Module, Bundler, API-Aufrufe oder Framework-Router. Wird statt des fertigen Exports der Arbeitsordner geöffnet, fehlen oft gebaute Dateien. Manche Browser blockieren lokale Modul- oder Fetch-Zugriffe. In SitePreviewKit bleibt die Vorschau zusätzlich in einem sandboxed iframe, damit Code nicht im Host-DOM läuft.

Einfache Lösung

Prüfen Sie, ob ein fertiger dist-, build- oder out-Ordner existiert.
Suchen Sie nach script-Tags und kontrollieren Sie, ob die verlinkten Dateien vorhanden sind.
Unterscheiden Sie statische Interaktion von Funktionen, die Server oder APIs benötigen.
Kommentieren Sie Probleme als Hinweis, statt JavaScript unüberlegt zu ändern.
Testen Sie wichtige Interaktionen später zusätzlich auf der echten Zielumgebung.

Typische Fehler

package.json hochladen und erwarten, dass npm automatisch läuft.
API-Funktionen ohne Backend testen wollen.
JavaScript-Dateien im Export vergessen.
Fehler durch externe Skripte mit Fehlern der eigenen Website verwechseln.

Checkliste

Fertiger Build hochgeladen
JS-Dateien im Export vorhanden
Keine erwarteten API-Routen für statische Vorschau
Konsole im Zielbrowser prüfen
Navigation und Formulare realistisch testen

FAQ

Warum laufen API-Funktionen lokal nicht?

Eine statische Vorschau hat keinen Server. API-Routen, Datenbanken oder Login-Flows brauchen eine andere Umgebung.

Führt SitePreviewKit JavaScript aus?

Die hochgeladene Website läuft nur in der sandboxed Vorschau, nicht im Host-DOM der App.

Soll ich JavaScript im Codeeditor ändern?

Nur wenn Sie wissen, was Sie tun. Änderungen bleiben lokal, können aber die Vorschau beeinflussen.