{"canonical_url":"https://engineer.company/de/glossary/service-worker/","content_markdown":"# Service Worker\n\n## Was es ist\n\nEin Service Worker ist ein Skript, das eine Website beim Browser registriert.\nDer Browser führt es getrennt von jeder Seite aus und leitet die\nNetzwerkanfragen der vom Service Worker kontrollierten Seiten durch dieses Skript. Service Worker sind\neine Art Web Worker: Jeder läuft in einem eigenen Thread ohne Dokument und ohne\nFenster. Der Browser startet ihn, wenn etwas zu bearbeiten ist, und darf ihn\nbeenden, sobald nichts mehr ansteht. Was in einer Variablen steht, kann deshalb\nbeim nächsten Ereignis schon verschwunden sein.\n\nEine Seite installiert ihn mit einem einzigen Aufruf. Die Spezifikation stellt\ndrei Bedingungen. Die Seite muss ein sicherer Kontext sein, praktisch also\nHTTPS, wobei `localhost` und Loopback-Adressen für die Entwicklung zulässig\nsind. Das Skript muss vom selben Origin wie die Seite stammen. Es kann daher\nnicht auf einem CDN liegen, darf aber Code von dort importieren. Außerdem hat\ndie Registrierung einen Geltungsbereich: standardmäßig den Ordner des Skripts\nund keinen größeren, sofern der Server nicht zusammen mit dem Skript einen\nHeader `Service-Worker-Allowed` sendet.\n\n```js\n// on the page\nnavigator.serviceWorker.register(\"/sw.js\");\n\n// in /sw.js\nasync function answer(request) {\n    const copy = await caches.match(request);\n    return copy ?? fetch(request);\n}\n\nself.addEventListener(\"fetch\", (event) =\u003e {\n    event.respondWith(answer(event.request));\n});\n```\n\nDieser Worker beantwortet jede Anfrage mit seiner eigenen Kopie, falls er eine\nhat, andernfalls aus dem Netz. Die Kopien bereitzulegen ist Aufgabe des\nLebenszyklus. Nach dem Abruf des Skripts löst der Browser `install` aus. Jetzt\nwird heruntergeladen und gespeichert, was der Worker brauchen wird. Wird ein\ndort an `event.waitUntil()` übergebenes Promise abgelehnt, scheitert die\nInstallation. Danach folgt `activate`, der Zeitpunkt zum Aufräumen der Reste\neiner älteren Version. Erst anschließend erhält der Worker `fetch`-Ereignisse.\nEine Seite wird beim Laden ihrem Worker zugeordnet. Die Seite, die den ersten\nWorker registriert hat, arbeitet deshalb bis zum Neuladen ohne ihn weiter,\nsofern der Worker nicht `clients.claim()` aufruft.\n\nDie Kopien liegen in Cache Storage. Dieselbe Spezifikation definiert diesen\nSpeicher als benannte Caches mit Anfrage-Antwort-Paaren, die der Worker selbst füllt, liest\nund löscht. Sie sind vom HTTP-Cache des Browsers getrennt. Ein Eintrag läuft\nnie ab, aktualisiert sich nie selbst und überlebt ein Update des Worker-Skripts.\nEr bleibt also liegen, bis der Worker ihn löscht oder der Browser den\nWebsite-Speicher leert.\n\n## Warum es wichtig ist\n\nService Worker geben einer Website explizite Kontrolle darüber, wie sie\nohne jede Netzverbindung weiterarbeitet. Ein Service Worker entscheidet für jede\nAnfrage mit vom Betreiber geschriebenem Code, ob er sie aus dem Netz, aus\neigenen Kopien oder aus einer Kombination beider Quellen beantwortet. Dadurch\nlässt sich eine installierte Web-App auf einem Schiff oder in einem Keller\nnutzen. Auch Push-Nachrichten erreichen ihn, wenn keine Seite der Website\ngeöffnet ist.\n\nBei den meisten Workern läuft es auf die Wahl einer Strategie pro Art von\nAnfrage hinaus. Workbox, eine Bibliothek zum Schreiben solcher Worker, benennt\nfünf. Cache first antwortet aus der Kopie und greift nur bei fehlender Kopie aufs\nNetz zu. Das passt zu Dateien, die sich unter demselben Namen nie ändern.\nNetwork first fragt das Netz und fällt bei einem Fehler auf die Kopie zurück.\nDas passt zu Seiten. Stale-while-revalidate antwortet aus der Kopie und\naktualisiert sie im Hintergrund. Network only und cache only sind die beiden\nExtreme.\n\nZugleich steht dieser Code auf dem Gerät des Lesers zwischen jeder Seite seines\nGeltungsbereichs und dem Netz und überlebt den Besuch. Ein Fehler bleibt also,\nbis ein korrigiertes Skript ihn ersetzt. Die Spezifikation ist um dieses Risiko\nherum entworfen. Bei jeder Navigation prüft der Browser auf ein neues Skript.\nAndere Ereignisse tun das, wenn seit der letzten Prüfung ein Tag vergangen ist.\nStandardmäßig wird das Hauptskript beim Server revalidiert statt aus dem\nHTTP-Cache bezogen. Ein langes `max-age` auf der Worker-Datei kann dadurch keine\nfehlerhafte Version festhalten. Importierte Skripte werden ebenso behandelt,\nwenn ein Tag vergangen ist, oder immer, wenn `updateViaCache` auf `none` steht.\nDer Browser vergleicht abgerufenes und installiertes Skript Byte für Byte. Nur\nein Unterschied startet die Aktualisierung. Ein Neuladen mit Umschalttaste\numgeht den Worker für diese Navigation. Deshalb kann ein Fehler auf dem\nEntwicklungsrechner behoben wirken.\n\nDie Warteregel ist die andere Hälfte des Entwurfs. Eine neue Version wird neben\nder alten installiert und wartet ungenutzt, bis keine offene Seite mehr von der\nalten abhängt. So bedienen nicht zwei Versionen gemeinsam dieselbe Seite. Ein\nAufruf von `skipWaiting()` erlaubt die sofortige Übernahme, allerdings läuft\ndann neuer Code unter Seiten, die noch die vorherige Version geladen hat.\n\nDer Speicher ist der letzte Kostenpunkt. Cache Storage verbraucht Platz im\nWebsite-Speicher auf dem Gerät des Lesers. Nach dem Storage Standard wird dieser\nPlatz standardmäßig ohne dauerhafte Zusicherung gewährt. Bei Platzmangel auf dem\nGerät darf der Browser ihn löschen, sofern die Website nicht persistenten\nSpeicher beantragt und bewilligt bekommen hat.\n\n## Wie es in der Praxis aussieht\n\nDer Nutzen zeigt sich am deutlichsten dort, wo das Netz am schwächsten ist.\n[Die progressive Web-App für Seeleute und Außendienstkräfte](/de/portfolio/delivered-full-progressive-web-app-support/)\nwird von Menschen genutzt, die oft ohne oder nur mit schlechter Verbindung\nunterwegs sind. Ihr Service Worker wird über das Plugin next-pwa konfiguriert.\nWorkbox verwendet im Laufzeitcache cache first für Dinge, die sich zwischen\nAnfragen nicht ändern: Schriftarten, Bilder, Audio, Video und CDN-Ressourcen,\nzusammen mit HTTP-Headern zur Cache-Steuerung. Weil Service Worker erst über\nHTTPS richtig funktionieren, wurden Offline- und Installationsverhalten über\nHTTPS auf echten Geräten getestet. Wiederholte Ladevorgänge kommen aus dem Cache\nstatt aus dem Netz.\n\nDiese Website entscheidet sich ausdrücklich für das Gegenteil.\n[Die Cookie-Seite](/de/cookies/) hält fest, dass es weder Service Worker noch\nIndexedDB noch Cache Storage gibt: Nichts von der Website läuft im Hintergrund, bevor jemand sie\nöffnet oder nachdem sie geschlossen wurde. Ihre Seiten liefern kein\nausführbares JavaScript aus. Der Suchcode bleibt deaktiviert erhalten und\nregistriert keinen Worker.\n\n[Die Installationsseite](/de/install/) erklärt die Folge für alle, die die Website\nzum Startbildschirm hinzufügen: Die Installation gibt ihr ein eigenes Fenster,\nlegt aber keine verwaltete Offline-Kopie an. Diese Website liefert weder einen\nService Worker noch skriptgesteuerten Offline-Speicher aus. Die installierte App\nbraucht daher für die normale Nutzung eine Verbindung.\n\nEin Worker wird durch ein ausführbares Skript registriert. Die\nContent-Security-Policy dieser Website verbietet das inzwischen auf allen\nSeiten mit `script-src 'none'`. JSON-LD bleibt auf inerte Daten beschränkt. Ein älterer Kommentar\nin der Head-Vorlage dokumentierte einen Build, in dem 550 von 793 Dokumenten\n`'none'` und 243 `'self'` deklarierten. Letztere entsprachen den Seiten mit dem\ndamals enthaltenen Listenfilter. Diese Zahlen beschreiben den früheren Build\nmit aktivierten Skripten und nicht die aktuelle Richtlinie.\n\n## Wo es schiefgeht\n\n**Nach einem Deployment antwortet weiterhin die alte Version.** Der neue Worker\ninstalliert sich und wartet dann, solange noch ein offener Tab den vorherigen\nverwendet. Wer diesen Tab nie schließt, führt weiter den alten Code aus. Rufen\nSie `skipWaiting()` auf, wenn die neue Version sicher unter Seiten laufen kann,\ndie die vorherige geladen hat. Oder zeigen Sie eine Aktualisierungsmeldung an\nund lassen Sie die Seite dem wartenden Worker eine Nachricht schicken, damit er\nden Aufruf ausführt.\n\n**Seiten bleiben wochenlang auf dem alten Stand.** Eine Cache-first-Strategie\nfür HTML beantwortet jede Navigation aus Cache Storage. Dessen Einträge laufen\nnie ab und beachten die Cache-Header des Servers nicht. Reservieren Sie cache\nfirst für Dateien, deren Name sich mit ihrem Inhalt ändert, und verwenden Sie\nnetwork first für Seiten.\n\n**Die Installation scheitert, und der alte Worker bleibt.** Eine Adresse aus\nder Liste des Installationsschritts antwortet mit einem Fehler. Dadurch wird\n`cache.addAll()` abgelehnt, ebenso das an `waitUntil()` übergebene Promise. Die\nneue Version wird verworfen. Bauen Sie die Liste aus vorhandenen Dateien auf und\nladen Sie optionale Dateien später statt während der Installation.\n\n**Der Worker ignoriert den größten Teil der Website.** Ein unter `/js/sw.js`\nausgeliefertes Skript hat `/js/` sowohl als standardmäßigen als auch als\nmaximalen Geltungsbereich. Seiten außerhalb dieses Ordners laden ohne ihn.\nLiefern Sie das Skript an der Website-Wurzel aus oder senden Sie damit\n`Service-Worker-Allowed: /`.\n\n**Die Speicherbelegung auf dem Gerät wächst mit jeder Veröffentlichung.** Caches überleben ein\nUpdate des Worker-Skripts. Jede Version, die einen Cache unter neuem Namen\nöffnet, lässt daher den vorherigen zurück. Nehmen Sie eine Version in jeden\nCache-Namen auf und löschen Sie im Handler für `activate` alle Caches, die die\naktuelle Version nicht verwendet.\n\n## Weiterführende Lektüre\n\n- [Service Workers](https://www.w3.org/TR/service-workers/) — Registrierung,\n  Geltungsbereich, Aktualisierungsprüfungen, Lebenszyklus und Cache Storage.\n- [Sichere Kontexte](https://www.w3.org/TR/secure-contexts/) — Welche Origins als\n  potenziell vertrauenswürdig gelten, einschließlich `localhost` und\n  Loopback-Adressen.\n- [Fetch Standard](https://fetch.spec.whatwg.org/) — Die Objekte `Request` und\n  `Response`, die ein `fetch`-Handler erhält und zurückgibt, und die Übergabe\n  einer Anfrage an einen Service Worker.\n- [Storage Standard](https://storage.spec.whatwg.org/) — Die Speicher-Buckets für\n  Cache Storage, Quotenschätzungen und der Antrag einer Website auf\n  persistenten Speicher.\n- [Workbox: workbox-strategies](https://developer.chrome.com/docs/workbox/modules/workbox-strategies)\n  — Die fünf Cache-Strategien und die jeweils passende Art von Anfrage.\n\n\u003chttps://engineer.company/de/glossary/service-worker/\u003e\n","date_modified":"2026-11-09T21:50:25Z","description":"Wie ein Service Worker zwischen Website und Netz steht, warum eine neue Version vor der Übernahme wartet und wo seine Caches veralten.","formats":{"gemtext":"https://engineer.company/de/glossary/service-worker/index.gmi","gopher":"https://engineer.company/de/glossary/service-worker/gophermap","html":"https://engineer.company/de/glossary/service-worker/","json":"https://engineer.company/de/glossary/service-worker/index.json","markdown":"https://engineer.company/de/glossary/service-worker/index.md","pdf":"https://engineer.company/de/glossary/service-worker/index.pdf"},"kind":"page","language":"de","title":"Was ist ein Service Worker?","url":"https://engineer.company/de/glossary/service-worker/","version":1}