# Progressive Web App

## Was es ist

Eine Progressive Web App, auch als progressive web app geschrieben und meist zu PWA abgekürzt, ist eine Website, die ein Browser installieren und wie eine App ausführen kann: über ein eigenes Symbol, in einem eigenen Fenster und häufig mit Teilen, die auch ohne Netzwerk weiterarbeiten. Dabei bleibt sie die ganze Zeit eine gewöhnliche Website. Nichts kommt aus einem App-Store; die Seiten bestehen aus demselben HTML, CSS und JavaScript, das ein Browser in einem Tab laden würde.

Kein Standard definiert den Begriff. Die Standards definieren die beiden Bestandteile, aus denen sie aufgebaut wird. Der erste ist das Web-App-Manifest, eine JSON-Datei nach der W3C-Spezifikation Web Application Manifest, die der App einen Namen, Symbole, eine Start-URL und einen Anzeigemodus gibt. Diese Spezifikation setzt die Hürde niedrig an: Jede Website sei eine installierbare Webanwendung. Ein Browser kann eine Installationsmöglichkeit anbieten; die installierte App öffnet sich dann mit den Einstellungen des Manifests. Im Anzeigemodus `standalone` soll sie einer nativen Anwendung ähneln. Das kann ein eigenes Fenster und ein Symbol im Anwendungsstarter bedeuten; der Browser lässt seine gewöhnliche Oberfläche wie die URL-Leiste weg.

Der zweite Bestandteil ist der Service Worker aus der W3C-Spezifikation Service Workers. Es ist ein Skript, das der Browser getrennt von der Seite ausführt. Es sitzt zwischen Seite und Netzwerk, sieht die Anfragen der Seite und kann sie aus selbst verwalteten Caches beantworten. Dadurch kann eine Web-App ihre Seiten auch offline weiter ausliefern. Diese Caches gehören dem Skript: Die Spezifikation trennt sie vollständig vom gewöhnlichen HTTP-Cache des Browsers. Sie ändern sich nur, wenn das Skript sie ändert.

Web Application Manifest verwendet das Wort „progressive“ nie; die Service-Workers-Spezifikation verwendet es einmal, in einer Anmerkung dazu, wie Chromium eine PWA erkennt. Die PWA-Anleitung von Next.js empfiehlt Progressive Enhancement, damit die App auch in einem Browser gut funktioniert, der manche PWA-Funktionen nicht unterstützt. In diesem Sinne ist jeder Bestandteil optional. Ein Browser, der das Manifest ignoriert oder keine Service Worker unterstützt, zeigt weiterhin die Website.

Eine Progressive Web App ist auch keine eigene Art von Website. Eine Single-Page-Anwendung, eine statische Website und eine serverseitig gerenderte Website können jeweils ein Manifest und einen Service Worker ergänzen. Der Begriff beschreibt, was ein Browser nach dem Laden mit einer Website tun kann, nicht, wie ihr HTML entsteht.

## Warum es wichtig ist

Die Anleitung von Next.js begründet den Einsatz mit drei Punkten. Aktualisierungen werden sofort veröffentlicht, ohne auf die Freigabe eines App-Stores zu warten. Eine Codebasis bedient jede Plattform. Und die App erhält Funktionen, die Menschen von nativen Apps erwarten, etwa Installation auf dem Startbildschirm und Push-Benachrichtigungen. Alle drei folgen daraus, dass die App eine Website bleibt: Eine neue Version kann ohne separate Veröffentlichung in einem App-Store bereitgestellt werden; wann das einzelne Gerät sie übernimmt, hängt vom Caching und von Service-Worker-Updates ab.

Offline-Nutzung ist der Grund für den Service Worker. Der Abschnitt zur Motivation in der Spezifikation sagt, Webanwendungen hätten traditionell ein erreichbares Netzwerk vorausgesetzt; andere Anwendungsplattformen gingen deshalb besser mit unterbrochenen Verbindungen um. Service Worker geben auch Webanwendungen einen Weg, solche Unterbrechungen zu bewältigen. Mit einem solchen Worker muss die Nutzung auch im Zug in einem Tunnel oder auf einem Schiff außer Reichweite der Küste nicht mehr auf der Fehlerseite des Browsers enden.

Die beiden Hälften sind unabhängig. Die Anleitung von Next.js weist darauf hin, dass Installationsaufforderungen keine Offline-Unterstützung brauchen; die Manifest-Spezifikation hat ihr eigenes Feld `serviceworker` entfernt. Eine App kann ohne Service Worker installierbar sein. Umgekehrt kann ein Service Worker eine gewöhnliche Website ganz ohne Manifest offline nutzbar machen.

Beiden Hälften gemeinsam ist HTTPS. Next.js nennt eine über HTTPS ausgelieferte Website als eine von zwei Voraussetzungen für die Installation einer App auf dem mobilen Startbildschirm; die andere ist ein gültiges Manifest. Laut Service-Workers-Spezifikation müssen Service Worker in sicheren Kontexten laufen. In der Praxis bedeutet das HTTPS, mit einer Ausnahme für localhost zur Entwicklung.

## Wie es in der Praxis aussieht

Drei kleine, eigens für diesen Artikel geschriebene Dateien ergeben eine funktionierende PWA. Das Manifest benennt die App, wählt den Anzeigemodus und führt ihre Symbole auf:

```json
{
  "name": "Field Notes",
  "short_name": "Notes",
  "start_url": "/",
  "display": "standalone",
  "icons": [
    { "src": "/icon-192.png", "sizes": "192x192", "type": "image/png" },
    { "src": "/icon-512.png", "sizes": "512x512", "type": "image/png" }
  ]
}
```

Jede Seite verlinkt das Manifest und registriert den Service Worker, allerdings nur in einem Browser, der ihn unterstützt:

```html
<link rel="manifest" href="/manifest.webmanifest" />
<script>
  if ("serviceWorker" in navigator) {
    navigator.serviceWorker.register("/sw.js");
  }
</script>
```

Der Service Worker hält eine kleine Menge von Dateien für die Offline-Nutzung vor:

```js
// sw.js
const CACHE = "shell-v2";
const SHELL = ["/offline.html", "/app.css", "/app.js"];

async function precache() {
  const cache = await caches.open(CACHE);
  await cache.addAll(SHELL);
}

async function dropOldCaches() {
  const names = await caches.keys();
  const old = names.filter((name) => name !== CACHE);
  await Promise.all(old.map((name) => caches.delete(name)));
}

async function respond(request) {
  if (request.mode === "navigate") {
    try {
      return await fetch(request);
    } catch {
      return caches.match("/offline.html");
    }
  }
  const hit = await caches.match(request);
  return hit ?? fetch(request);
}

self.addEventListener("install", (event) => {
  event.waitUntil(precache());
});

self.addEventListener("activate", (event) => {
  event.waitUntil(dropOldCaches());
});

self.addEventListener("fetch", (event) => {
  if (event.request.method !== "GET") return;
  event.respondWith(respond(event.request));
});
```

Das Manifest verwendet `.webmanifest`, die dafür registrierte Dateiendung, und wird mit dem Medientyp `application/manifest+json` ausgeliefert. Der Service Worker liegt im Wurzelverzeichnis, weil sein Geltungsbereich standardmäßig dem Verzeichnis des Skripts entspricht. Ein Worker unter `/js/sw.js` könnte deshalb nur Seiten unter `/js/` steuern, sofern der Server keinen Header `Service-Worker-Allowed` sendet. Bei der Installation öffnet er einen Cache namens `shell-v2` und speichert Offline-Seite, Stylesheet und Skript. `addAll()` schlägt fehl, wenn eine dieser Dateien einen Fehlerstatus zurückliefert. Weil `waitUntil()` dieses Promise erhalten hat, schlägt damit die gesamte Installation fehl, statt einen halb gefüllten Cache zu hinterlassen. Bei der Aktivierung löscht er jeden anders benannten Cache. Seitennavigationen gehen zuerst ans Netzwerk und fallen auf die gespeicherte Offline-Seite zurück, wenn es nicht antwortet. Alles andere wird, falls vorhanden, aus dem Cache bedient und andernfalls abgerufen. Anfragen mit einer anderen Methode als `GET` bleiben unberührt.

Das Unternehmen beschreibt eine vollständige Umsetzung auf einer realen Plattform. [Der Portfolioeintrag](/de/portfolio/delivered-full-progressive-web-app-support/) erklärt den Bedarf: Viele Nutzer der Plattform sind Seeleute und Außendienstmitarbeiter mit Mobiltelefonen, häufig offline oder mit schwacher Verbindung. Die App musste sich deshalb wie eine native App installieren lassen und bei Signalverlust weiterarbeiten. Der Eintrag behandelt beide Hälften. Die App lässt sich auf dem Startbildschirm installieren und bringt Symbole in mehreren Größen, einen Splashscreen und Designfarben mit. Der Service Worker wird über das Plugin next-pwa eingerichtet. Das Laufzeit-Caching von Workbox liefert Schriftarten, Bilder, Audio, Video und CDN-Dateien nach dem Cache-first-Prinzip aus, weil diese sich nicht von Anfrage zu Anfrage ändern; hinzu kommen HTTP-Cache-Control-Header. Weil Service Worker HTTPS benötigen, wurden Installation und Offline-Verhalten über HTTPS auf echten Geräten getestet. Als Ergebnis nennt der Bericht eine App, die Menschen installieren und offline weiterverwenden; bei erneuten Besuchen lädt sie aus dem Cache.

Auch die Installation sieht aus Lesersicht unterschiedlich aus. Die [Anleitung zur Installation dieser Website als App](/de/install/) zeigt, wo die einzelnen Browser den Befehl anbieten: im Teilen-Menü unter „Zum Home-Bildschirm“ in Safari auf dem iPhone, über ein kleines Symbol rechts in der Adressleiste von Chrome, Edge, Brave, Opera und Vivaldi auf einem Computer sowie über „Zum Dock hinzufügen“ in Safari ab macOS Sonoma. Sie hält auch fest, dass iOS nie von sich aus eine Installation vorschlägt. Firefox bietet unter Windows ab Version 143 eigene Web-App-Fenster, bei Installationen aus dem Microsoft Store ab Version 150, nicht jedoch unter macOS oder Linux. Die Seite sagt ebenso klar, was die Installation dieser Website liefert: ein Symbol und ein Fenster, aber keine Offline-Kopie, denn Offline-Unterstützung braucht einen Service Worker.

## Wo es schiefgeht

**Nutzer behalten die alte Version.** Laut Service-Workers-Spezifikation werden Cache-Objekte nur auf ausdrückliche Anweisung des Autors aktualisiert und verfallen nur, wenn er sie löscht. Ein Cache-first-Worker liefert deshalb das gestrige Stylesheet, bis sein Skript etwas anderes vorgibt. Nehmen Sie eine Version in den Cache-Namen auf, ändern Sie sie bei jeder Änderung gespeicherter Dateien und löschen Sie die alten Caches bei der Aktivierung, wie im Beispiel. Eine Skriptänderung startet die Aktualisierung, weil der Browser das neu abgerufene `sw.js` Byte für Byte mit der installierten Fassung vergleicht. Selbst dann wartet der neue Worker, bis kein Tab und kein Fenster den alten verwendet, sofern er nicht `skipWaiting()` aufruft. Wer einen Tab offen lässt, verwendet daher die vorherige Version so lange, wie dieser offen bleibt. Die Anleitung von Next.js liefert `sw.js` mit `Cache-Control: no-cache, no-store, must-revalidate` aus, damit Nutzer immer die neueste Fassung des Workers selbst erhalten.

**Es funktioniert auf dem Laptop, aber nicht auf dem Testtelefon.** `navigator.serviceWorker` existiert nur in sicheren Kontexten. Auf einer über einfaches HTTP ausgelieferten Seite ergibt die übliche Funktionsprüfung stillschweigend false. Der Worker wird nie registriert, und die Seite meldet nichts davon. Die Spezifikation erlaubt Browsern, localhost, 127.0.0.0/8 und ::1/128 für die Entwicklung zuzulassen. Deshalb kann ein auf dem eigenen Entwicklungsrechner funktionierender Worker fehlen, wenn ein Telefon dieselbe App per HTTP über die lokale Netzwerkadresse dieses Rechners öffnet. Next.js bietet für lokale HTTPS-Tests `next dev --experimental-https`. Testen Sie Installation und Offline-Verhalten auf echten Geräten über HTTPS, bevor Sie eines von beiden als erledigt betrachten.

**Ein Fetch-Listener tut nichts.** Die Service-Workers-Spezifikation hält fest, dass manche Websites einen `fetch`-Listener mit leerem Rumpf registrieren, nur damit Chromium sie als Progressive Web App erkennt. Die Spezifikation erkennt inzwischen Listener wie `() => {}` und empfiehlt Browsern die Warnung, dass solche Listener unnötig sind und die Leistung beeinträchtigen können. Schreiben Sie einen Handler, der Anfragen beantwortet, oder lassen Sie den Listener weg.

**Sich auf eine Installationsaufforderung verlassen.** Ob und wie eine Installation angeboten wird, entscheidet der Browser. Next.js sagt, moderne Browser zeigten automatisch eine Installationsaufforderung, sobald eine Website ein gültiges Manifest und HTTPS hat. Die Anleitung rät davon ab, einen eigenen Installationsknopf auf `beforeinstallprompt` aufzubauen: Dieses Ereignis funktioniert nicht über alle Browser und Plattformen hinweg, Safari unter iOS eingeschlossen. Die Manifest-Spezifikation hat das Ereignis inzwischen ganz entfernt. Auch Anzeigemodus und Start-URL sind nur Empfehlungen. Ein Browser ohne Unterstützung für `standalone` fällt erst auf `minimal-ui` und dann auf `browser` zurück, also auf einen gewöhnlichen Tab. Erklären Sie Nutzern die Installation, wie es die iOS-Anweisungen der Next.js-Anleitung tun, und entwerfen Sie die App so, dass sie auch in einem Tab geöffnet werden kann.

## Weiterführende Lektüre

- [Web Application Manifest](https://www.w3.org/TR/appmanifest/) — Manifestformat, Felder und Anzeigemodi sowie die Bedeutung von Installation und Deinstallation.
- [Service Workers](https://www.w3.org/TR/service-workers/) — Lebenszyklus, Geltungsbereich und Aktualisierungsregeln des Workers, die Anforderung sicherer Kontexte und die Cache API.
- [Web Application Manifest: Installierbare Webanwendungen](https://www.w3.org/TR/appmanifest/#installable-web-applications) — wie ein Browser eine Webanwendung installiert, startet und wieder entfernen lässt.
- [Service Workers: Lebensdauer von Caches verstehen](https://www.w3.org/TR/service-workers/#cache-lifetimes) — warum Cache-Objekte sich nie aktualisieren oder verfallen, sofern das Skript es nicht anordnet.
- [Eine Progressive Web Application (PWA) mit Next.js erstellen](https://nextjs.org/docs/app/guides/progressive-web-apps) — Manifestdatei, Push-Benachrichtigungen, Installationsanweisungen für iOS, HTTPS in der Entwicklung und Sicherheitsheader für den Service Worker.

<https://engineer.company/de/glossary/progressive-web-app/>
