# Service Worker

## Was es ist

Ein Service Worker ist ein Skript, das eine Website beim Browser registriert. Der Browser führt es getrennt von jeder Seite aus und leitet die Netzwerkanfragen der vom Service Worker kontrollierten Seiten durch dieses Skript. Service Worker sind eine Art Web Worker: Jeder läuft in einem eigenen Thread ohne Dokument und ohne Fenster. Der Browser startet ihn, wenn etwas zu bearbeiten ist, und darf ihn beenden, sobald nichts mehr ansteht. Was in einer Variablen steht, kann deshalb beim nächsten Ereignis schon verschwunden sein.

Eine Seite installiert ihn mit einem einzigen Aufruf. Die Spezifikation stellt drei Bedingungen. Die Seite muss ein sicherer Kontext sein, praktisch also HTTPS, wobei `localhost` und Loopback-Adressen für die Entwicklung zulässig sind. Das Skript muss vom selben Origin wie die Seite stammen. Es kann daher nicht auf einem CDN liegen, darf aber Code von dort importieren. Außerdem hat die Registrierung einen Geltungsbereich: standardmäßig den Ordner des Skripts und keinen größeren, sofern der Server nicht zusammen mit dem Skript einen Header `Service-Worker-Allowed` sendet.

```js
// on the page
navigator.serviceWorker.register("/sw.js");

// in /sw.js
async function answer(request) {
    const copy = await caches.match(request);
    return copy ?? fetch(request);
}

self.addEventListener("fetch", (event) => {
    event.respondWith(answer(event.request));
});
```

Dieser Worker beantwortet jede Anfrage mit seiner eigenen Kopie, falls er eine hat, andernfalls aus dem Netz. Die Kopien bereitzulegen ist Aufgabe des Lebenszyklus. Nach dem Abruf des Skripts löst der Browser `install` aus. Jetzt wird heruntergeladen und gespeichert, was der Worker brauchen wird. Wird ein dort an `event.waitUntil()` übergebenes Promise abgelehnt, scheitert die Installation. Danach folgt `activate`, der Zeitpunkt zum Aufräumen der Reste einer älteren Version. Erst anschließend erhält der Worker `fetch`-Ereignisse. Eine Seite wird beim Laden ihrem Worker zugeordnet. Die Seite, die den ersten Worker registriert hat, arbeitet deshalb bis zum Neuladen ohne ihn weiter, sofern der Worker nicht `clients.claim()` aufruft.

Die Kopien liegen in Cache Storage. Dieselbe Spezifikation definiert diesen Speicher als benannte Caches mit Anfrage-Antwort-Paaren, die der Worker selbst füllt, liest und löscht. Sie sind vom HTTP-Cache des Browsers getrennt. Ein Eintrag läuft nie ab, aktualisiert sich nie selbst und überlebt ein Update des Worker-Skripts. Er bleibt also liegen, bis der Worker ihn löscht oder der Browser den Website-Speicher leert.

## Warum es wichtig ist

Service Worker geben einer Website explizite Kontrolle darüber, wie sie ohne jede Netzverbindung weiterarbeitet. Ein Service Worker entscheidet für jede Anfrage mit vom Betreiber geschriebenem Code, ob er sie aus dem Netz, aus eigenen Kopien oder aus einer Kombination beider Quellen beantwortet. Dadurch lässt sich eine installierte Web-App auf einem Schiff oder in einem Keller nutzen. Auch Push-Nachrichten erreichen ihn, wenn keine Seite der Website geöffnet ist.

Bei den meisten Workern läuft es auf die Wahl einer Strategie pro Art von Anfrage hinaus. Workbox, eine Bibliothek zum Schreiben solcher Worker, benennt fünf. Cache first antwortet aus der Kopie und greift nur bei fehlender Kopie aufs Netz zu. Das passt zu Dateien, die sich unter demselben Namen nie ändern. Network first fragt das Netz und fällt bei einem Fehler auf die Kopie zurück. Das passt zu Seiten. Stale-while-revalidate antwortet aus der Kopie und aktualisiert sie im Hintergrund. Network only und cache only sind die beiden Extreme.

Zugleich steht dieser Code auf dem Gerät des Lesers zwischen jeder Seite seines Geltungsbereichs und dem Netz und überlebt den Besuch. Ein Fehler bleibt also, bis ein korrigiertes Skript ihn ersetzt. Die Spezifikation ist um dieses Risiko herum entworfen. Bei jeder Navigation prüft der Browser auf ein neues Skript. Andere Ereignisse tun das, wenn seit der letzten Prüfung ein Tag vergangen ist. Standardmäßig wird das Hauptskript beim Server revalidiert statt aus dem HTTP-Cache bezogen. Ein langes `max-age` auf der Worker-Datei kann dadurch keine fehlerhafte Version festhalten. Importierte Skripte werden ebenso behandelt, wenn ein Tag vergangen ist, oder immer, wenn `updateViaCache` auf `none` steht. Der Browser vergleicht abgerufenes und installiertes Skript Byte für Byte. Nur ein Unterschied startet die Aktualisierung. Ein Neuladen mit Umschalttaste umgeht den Worker für diese Navigation. Deshalb kann ein Fehler auf dem Entwicklungsrechner behoben wirken.

Die Warteregel ist die andere Hälfte des Entwurfs. Eine neue Version wird neben der alten installiert und wartet ungenutzt, bis keine offene Seite mehr von der alten abhängt. So bedienen nicht zwei Versionen gemeinsam dieselbe Seite. Ein Aufruf von `skipWaiting()` erlaubt die sofortige Übernahme, allerdings läuft dann neuer Code unter Seiten, die noch die vorherige Version geladen hat.

Der Speicher ist der letzte Kostenpunkt. Cache Storage verbraucht Platz im Website-Speicher auf dem Gerät des Lesers. Nach dem Storage Standard wird dieser Platz standardmäßig ohne dauerhafte Zusicherung gewährt. Bei Platzmangel auf dem Gerät darf der Browser ihn löschen, sofern die Website nicht persistenten Speicher beantragt und bewilligt bekommen hat.

## Wie es in der Praxis aussieht

Der Nutzen zeigt sich am deutlichsten dort, wo das Netz am schwächsten ist. Die progressive Web-App für Seeleute und Außendienstkräfte wird von Menschen genutzt, die oft ohne oder nur mit schlechter Verbindung unterwegs sind. Ihr Service Worker wird über das Plugin next-pwa konfiguriert. Workbox verwendet im Laufzeitcache cache first für Dinge, die sich zwischen Anfragen nicht ändern: Schriftarten, Bilder, Audio, Video und CDN-Ressourcen, zusammen mit HTTP-Headern zur Cache-Steuerung. Weil Service Worker erst über HTTPS richtig funktionieren, wurden Offline- und Installationsverhalten über HTTPS auf echten Geräten getestet. Wiederholte Ladevorgänge kommen aus dem Cache statt aus dem Netz.

Diese Website entscheidet sich ausdrücklich für das Gegenteil. Die Cookie-Seite hält fest, dass es weder Service Worker noch IndexedDB noch Cache Storage gibt: Nichts von der Website läuft im Hintergrund, bevor jemand sie öffnet oder nachdem sie geschlossen wurde. Ihre Seiten liefern kein ausführbares JavaScript aus. Der Suchcode bleibt deaktiviert erhalten und registriert keinen Worker.

Die Installationsseite erklärt die Folge für alle, die die Website zum Startbildschirm hinzufügen: Die Installation gibt ihr ein eigenes Fenster, legt aber keine verwaltete Offline-Kopie an. Diese Website liefert weder einen Service Worker noch skriptgesteuerten Offline-Speicher aus. Die installierte App braucht daher für die normale Nutzung eine Verbindung.

Ein Worker wird durch ein ausführbares Skript registriert. Die Content-Security-Policy dieser Website verbietet das inzwischen auf allen Seiten mit `script-src 'none'`. JSON-LD bleibt auf inerte Daten beschränkt. Ein älterer Kommentar in der Head-Vorlage dokumentierte einen Build, in dem 550 von 793 Dokumenten `'none'` und 243 `'self'` deklarierten. Letztere entsprachen den Seiten mit dem damals enthaltenen Listenfilter. Diese Zahlen beschreiben den früheren Build mit aktivierten Skripten und nicht die aktuelle Richtlinie.

## Wo es schiefgeht

Nach einem Deployment antwortet weiterhin die alte Version. Der neue Worker installiert sich und wartet dann, solange noch ein offener Tab den vorherigen verwendet. Wer diesen Tab nie schließt, führt weiter den alten Code aus. Rufen Sie `skipWaiting()` auf, wenn die neue Version sicher unter Seiten laufen kann, die die vorherige geladen hat. Oder zeigen Sie eine Aktualisierungsmeldung an und lassen Sie die Seite dem wartenden Worker eine Nachricht schicken, damit er den Aufruf ausführt.

Seiten bleiben wochenlang auf dem alten Stand. Eine Cache-first-Strategie für HTML beantwortet jede Navigation aus Cache Storage. Dessen Einträge laufen nie ab und beachten die Cache-Header des Servers nicht. Reservieren Sie cache first für Dateien, deren Name sich mit ihrem Inhalt ändert, und verwenden Sie network first für Seiten.

Die Installation scheitert, und der alte Worker bleibt. Eine Adresse aus der Liste des Installationsschritts antwortet mit einem Fehler. Dadurch wird `cache.addAll()` abgelehnt, ebenso das an `waitUntil()` übergebene Promise. Die neue Version wird verworfen. Bauen Sie die Liste aus vorhandenen Dateien auf und laden Sie optionale Dateien später statt während der Installation.

Der Worker ignoriert den größten Teil der Website. Ein unter `/js/sw.js` ausgeliefertes Skript hat `/js/` sowohl als standardmäßigen als auch als maximalen Geltungsbereich. Seiten außerhalb dieses Ordners laden ohne ihn. Liefern Sie das Skript an der Website-Wurzel aus oder senden Sie damit `Service-Worker-Allowed: /`.

Die Speicherbelegung auf dem Gerät wächst mit jeder Veröffentlichung. Caches überleben ein Update des Worker-Skripts. Jede Version, die einen Cache unter neuem Namen öffnet, lässt daher den vorherigen zurück. Nehmen Sie eine Version in jeden Cache-Namen auf und löschen Sie im Handler für `activate` alle Caches, die die aktuelle Version nicht verwendet.

## Weiterführende Lektüre
* Service Workers — Registrierung, Geltungsbereich, Aktualisierungsprüfungen, Lebenszyklus und Cache Storage.
* Sichere Kontexte — Welche Origins als potenziell vertrauenswürdig gelten, einschließlich `localhost` und Loopback-Adressen.
* Fetch Standard — Die Objekte `Request` und `Response`, die ein `fetch`-Handler erhält und zurückgibt, und die Übergabe einer Anfrage an einen Service Worker.
* Storage Standard — Die Speicher-Buckets für Cache Storage, Quotenschätzungen und der Antrag einer Website auf persistenten Speicher.
* Workbox: workbox-strategies — Die fünf Cache-Strategien und die jeweils passende Art von Anfrage.

=> /de/portfolio/delivered-full-progressive-web-app-support/ Die progressive Web-App für Seeleute und Außendienstkräfte
=> /de/cookies/ Die Cookie-Seite
=> /de/install/ Die Installationsseite
=> https://www.w3.org/TR/service-workers/ Service Workers
=> https://www.w3.org/TR/secure-contexts/ Sichere Kontexte
=> https://fetch.spec.whatwg.org/ Fetch Standard
=> https://storage.spec.whatwg.org/ Storage Standard
=> https://developer.chrome.com/docs/workbox/modules/workbox-strategies Workbox: workbox-strategies

=> https://engineer.company/de/glossary/service-worker/ Diese Seite im Web
