Lorixen.
DE

Service Worker liefert alte Version: Updates zuverlässig

Kurz gesagt: Wenn Ihre Web-App einen Service Worker nutzt, etwa für Offline-Funktionen oder schnelles Laden, sehen manche Nutzer nach einem Update tagelang die alte Version. Das ist kein Fehler, sondern das Standardverhalten: Laut web.dev wartet ein neuer Service Worker nach der Installation, bis der alte keine geöffneten Seiten mehr steuert. Ein einfaches Neuladen reicht dafür oft nicht. Die zuverlässige Lösung ist ein Hinweis „Neue Version verfügbar“, der den wartenden Service Worker auf Wunsch aktiviert und die Seite neu lädt. Für Nutzer, die die App lange geöffnet lassen, prüfen Sie zusätzlich regelmäßig mit update() auf neue Versionen.

Woran Sie das Problem erkennen

Veraltete Versionen durch Service Worker zeigen sich typischerweise so:

  • Nach einem Update meldet ein Teil der Nutzer weiterhin alte Texte, Preise oder Fehler, die längst behoben sind.
  • Neu laden hilft nicht, erst das Schließen aller Tabs oder ein Neustart des Browsers.
  • Auf Handys, wo die App als installierte Web-App läuft, bleibt die alte Version besonders lange.
  • Im Support lautet die häufigste Antwort „Bitte die App komplett schließen“.

Gerade bei Bestell- und Buchungs-Apps ist das heikel, wenn sich Angebote, Öffnungszeiten oder Abläufe geändert haben.

Warum der neue Service Worker wartet

Ein Service Worker steuert die Seiten seiner Web-App: Er beantwortet Anfragen, oft aus einem eigenen Zwischenspeicher. Laut web.dev prüft der Browser nach Navigationen und bestimmten Ereignissen automatisch, ob es eine neue Fassung gibt. Als neu gilt ein Service Worker, wenn sich seine Datei auch nur um ein Byte unterscheidet.

Findet der Browser eine neue Fassung, wird sie installiert, aber noch nicht aktiviert. Laut web.dev wartet der neue Service Worker, bis der bestehende keine Seiten mehr steuert. Bei einem normalen Neuladen überlappen alte und neue Seite kurz, deshalb bleibt der alte Service Worker im Amt. Erst wenn alle Tabs der App geschlossen sind, übernimmt der neue.

Dieses Verhalten ist gewollt. Es verhindert, dass eine Seite, die mit der alten Version begonnen hat, plötzlich von einer neuen gesteuert wird, die vielleicht andere Daten oder Zwischenspeicher erwartet.

skipWaiting: schnell, aber mit Risiko

Laut web.dev verhindert self.skipWaiting() das Warten: Der neue Service Worker wird aktiviert, sobald er installiert ist. Das klingt nach der einfachsten Lösung. web.dev weist aber darauf hin, dass dann der neue Service Worker Anfragen von Seiten beantwortet, die noch mit der alten Version geladen wurden. Wenn das zu Problemen führen kann, sollten Sie skipWaiting nicht pauschal verwenden.

Ein Beispiel: Die alte Seite erwartet eine Datei, die der neue Service Worker aus seinem Zwischenspeicher gelöscht hat. Dann fehlen plötzlich Bilder oder Skripte.

Die bessere Lösung: Nutzer entscheiden lassen

Bewährt hat sich ein Ablauf in vier Schritten:

  1. Die Seite erkennt, dass ein neuer Service Worker installiert ist und wartet.
  2. Sie zeigt einen dezenten Hinweis: „Eine neue Version ist verfügbar. Jetzt aktualisieren?“
  3. Tippt der Nutzer auf „Aktualisieren“, schickt die Seite dem wartenden Service Worker eine Nachricht, und dieser ruft skipWaiting auf.
  4. Sobald der neue Service Worker die Steuerung übernommen hat, lädt die Seite einmal neu.

So entscheidet der Nutzer über den Zeitpunkt, etwa erst nach dem Abschicken einer Bestellung, und es entsteht keine Mischung aus alter Seite und neuem Service Worker. Viele Bibliotheken für Service Worker bieten für diesen Ablauf fertige Bausteine.

Lange geöffnete Apps regelmäßig prüfen

Manche Nutzer lassen eine Web-App stundenlang geöffnet, etwa eine Kassen- oder Küchenansicht im Betrieb. Dort finden kaum Navigationen statt, und der Browser prüft seltener auf Updates. Laut web.dev können Sie die Prüfung über die Registrierung des Service Workers mit update() manuell auslösen und, wenn Nutzer die Seite lange nicht neu laden, in einem Intervall aufrufen, zum Beispiel stündlich.

Was Sie vermeiden sollten

Neue Adresse für jede Version. web.dev rät ausdrücklich davon ab, dem Service Worker für jede Version eine eigene Adresse zu geben. Aktualisieren Sie die Datei an ihrem bisherigen Ort.

Lange Cache-Dauer für die Service-Worker-Datei. Laut web.dev ignorieren die meisten Browser beim Prüfen der registrierten Service-Worker-Datei standardmäßig Caching-Header. Für Skripte, die der Service Worker mit importScripts nachlädt, gelten die Header aber. Halten Sie die Cache-Dauer für diese Dateien deshalb kurz.

Zwischenspeicher ohne Versionen. Geben Sie den Caches Ihres Service Workers Versionsnamen und räumen Sie alte Caches beim Aktivieren der neuen Version auf. Sonst sammeln sich alte Dateien, und Nutzer bekommen gemischte Inhalte.

Für Entwickler: Testen ohne Wartezeit

Beim Entwickeln stört das Warten. web.dev beschreibt in den Entwicklerwerkzeugen von Chrome die Option „Update on reload“: Bei jeder Navigation wird der Service Worker neu geholt, installiert und ohne Wartephase aktiviert. Außerdem umgeht ein erzwungenes Neuladen mit gedrückter Umschalttaste den Service Worker ganz. Beides ist nur für Tests gedacht. Echte Nutzer erleben den normalen Ablauf, und den sollten Sie vor jeder Veröffentlichung einmal bewusst durchspielen.

Ein Testablauf vor jeder Veröffentlichung

  1. Alte Version im Browser öffnen und die App benutzen.
  2. Neue Version veröffentlichen.
  3. Seite neu laden: Erscheint der Hinweis auf die neue Version?
  4. Auf „Aktualisieren“ tippen: Lädt die Seite einmal neu und zeigt die neue Version?
  5. Dasselbe auf einem Handy mit installierter Web-App wiederholen.
  6. Prüfen, ob alte Caches entfernt wurden.

Beispiel aus der Praxis

Ein Yogastudio mit Standorten in Zürich und Wien betreibt eine Web-App für Kursplan und Buchung, die viele Mitglieder auf dem Startbildschirm installiert haben. Nach einer Umstellung der Stornoregeln sahen zahlreiche Mitglieder noch tagelang die alten Hinweise. Der neue Service Worker wartete, weil die installierte App nie ganz geschlossen wurde. Nach Einführung eines Hinweises „Neue Version verfügbar“ mit Aktualisieren-Knopf und einer stündlichen Update-Prüfung sind neue Versionen innerhalb kurzer Zeit bei den Nutzern. Das Beispiel ist illustrativ.

Häufige Fragen

Warum hilft Neuladen nicht?

Beim Neuladen überlappen alte und neue Seite kurz. Laut web.dev bleibt der alte Service Worker deshalb aktiv, bis keine Seite der App mehr geöffnet ist.

Soll ich einfach skipWaiting verwenden?

Nur, wenn alte Seiten mit dem neuen Service Worker sicher funktionieren. Sonst ist ein Hinweis mit Aktualisieren-Knopf die sicherere Wahl.

Wie oft sollte die App auf Updates prüfen?

Der Browser prüft nach Navigationen von selbst. Für lange geöffnete Apps empfiehlt web.dev eine manuelle Prüfung in einem Intervall, etwa stündlich.

Muss ich den Dateinamen des Service Workers ändern?

Nein. web.dev rät davon ab. Ändern Sie die Datei an ihrem bisherigen Ort.

Wenn Ihre Web-App nach Updates bei Nutzern hängen bleibt, richten wir den Update-Ablauf gerne gemeinsam mit Ihnen ein: Service Worker prüfen lassen.

Quellen

WhatsAppTermin buchen