{"canonical_url":"https://engineer.company/de/glossary/single-page-application/","content_markdown":"# Single-Page-Anwendung\n\n## Was es ist\n\nEine Single-Page-Anwendung, auch Single-Page-App und meist kurz SPA genannt, ist\neine Webanwendung, die ein HTML-Dokument lädt und es anschließend mit JavaScript\nverändert, statt beim Server eine neue Seite anzufordern. Ein Klick auf einen\ninternen Link entlädt die Seite nicht. Ein Skript fängt den Klick ab, lädt die\nfür die nächste Ansicht benötigten Daten, schreibt einen Teil des DOM um und\naktualisiert die Adressleiste. Die URL zeigt dadurch weiterhin die aktuelle\nPosition in der Anwendung an.\n\nKein Standard definiert den Begriff verbindlich, und die Hersteller der\nWerkzeuge räumen das ein. Next.js beginnt seinen Leitfaden dazu mit „Die\nDefinition einer SPA variiert“ und legt dann für sich selbst eine sogenannte\nstrikte SPA fest. Sie hat zwei Eigenschaften. Eine einzige HTML-Datei bedient\ndie ganze Anwendung, und JavaScript im Browser kümmert sich um jede Route,\njeden Seitenwechsel und jede Datenanfrage. Außerdem wird die Seite nie ganz neu\ngeladen: Bei einem Routenwechsel schreiben Skripte auf dem Client das DOM der\nbereits geöffneten Seite um und laden Daten nach Bedarf, statt vom Server ein\nneues Dokument anzufordern. Dieser Artikel verwendet diese Definition, weil sie\ndie direkteste verfügbare ist und die Eigenschaft benennt, von der alles andere\nabhängt: ein Dokument, das nie ersetzt wird.\n\nDie Browserbausteine sind standardisiert. Die History-Schnittstelle des\nHTML-Standards stellt einer Seite `history.pushState()` bereit. Der Aufruf fügt\ndem Sitzungsverlauf einen Eintrag hinzu und setzt die URL, ohne etwas zu laden.\n`history.replaceState()` überschreibt stattdessen den aktuellen Eintrag.\nWechselt jemand mit Zurück oder Vorwärts zwischen diesen Einträgen, löst der\nBrowser am Fenster ein `popstate`-Ereignis aus und überlässt der Seite das\nNeuzeichnen. Die neuere Navigation API, die der Standard als Nachfolgerin der\nklassischen Location- und History-APIs vorstellt, setzt am anderen Ende an: Zu\nBeginn einer Navigation wird ein `navigate`-Ereignis ausgelöst. Seine Methode\n`intercept()` macht daraus eine Navigation innerhalb desselben Dokuments, die\ndie Seite selbst behandelt.\n\nDas Gegenteil ist die gewöhnliche Website mit mehreren Seiten. Jeder Link\nfordert dort ein neues Dokument vom Server an, und der Browser verwirft das\nalte. Ob das HTML einer Seite einmal durch einen statischen Site-Generator oder\nbei jeder Anfrage durch serverseitiges Rendering entsteht, ist eine andere\nFrage. Sie betrifft die Erzeugung des HTML und nicht das, was nach seiner\nAnkunft im Browser geschieht. Next.js verwischt die Grenze bewusst: Sein statischer Export schreibt\nfür jede Route eine HTML-Datei, und der Wechsel zwischen ihnen findet trotzdem\nauf dem Client statt.\n\n## Warum es wichtig ist\n\nWeil das Dokument nie ersetzt wird, übersteht alles darin einen Klick: ein halb\nausgefülltes Formular, ein laufendes Video, die Scrollposition einer\nSeitenleiste, bereits abgerufene Daten. Nur die für die nächste Ansicht benötigten Daten\nmüssen durchs Netz, keine ganz neue Seite samt Kopfbereich, Stilen und Skripten.\nEin Ansichtswechsel kann sich auf das Umschreiben eines einzigen Bereichs der\nSeite beschränken.\n\nNext.js nennt die Kosten im selben Atemzug wie die Definition. Eine strikte SPA\nmuss oft viel JavaScript laden, bevor die Seite interaktiv wird.\nDatenanfragekaskaden auf dem Client, bei denen eine Anfrage erst nach der\nAntwort auf eine andere beginnen kann, sind schwer zu steuern. Auch für Systeme, die die\nSeite ohne Skriptausführung lesen, hat das Nachteile. Steht hinter jeder\nRoute eine einzige HTML-Datei, erhält ein Crawler ohne JavaScript stets dasselbe\nfast leere Dokument, egal welche URL er anfragt. Next.js sagt dasselbe über\nseine ausschließlich im Browser ausgeführten Komponenten: Wer die Seite ohne\nSkriptausführung indexiert, erhält den Ersatzinhalt statt der Komponente.\n\nDie Antwort von Next.js besteht darin, die clientseitige Navigation zu behalten\nund den Rest zu verlagern. Next.js teilt JavaScript-Bundles automatisch auf und\nerzeugt mehrere HTML-Einstiegspunkte für verschiedene Routen. Besucher laden so\nkeinen Code, den eine Route nicht braucht. Seine Komponente `next/link` lädt\nRouten im Voraus. Routenwechsel wirken dadurch so unmittelbar wie in einer\nvollständig auf dem Client gerenderten SPA. Zugleich bleibt der Routing-Zustand\nder Anwendung in der URL und lässt sich verlinken und teilen. Ein statischer\nExport geht weiter und schreibt für jede Route eine vollständig gerenderte\nSeite. Besucher erhalten dadurch Inhalt, ohne auf das Client-Bundle zu warten,\nwährend clientseitige Seitenwechsel so schnell wie in einer strikten SPA\nbleiben.\n\nDie Entscheidung fällt auch nicht ein für alle Mal. Next.js beschreibt ein\nProjekt, das als statische Website oder sogar als vollständig clientseitig\ngerenderte strikte SPA beginnt und beim Wachsen Serverfunktionen ergänzt. Eine\nbestehende SPA könne umziehen, ohne von Grund auf neu geschrieben zu werden.\n\n## Wie es in der Praxis aussieht\n\nDer folgende, für diesen Artikel geschriebene Router ist die kleinste\nfunktionsfähige Fassung der Idee. Er setzt ein `\u003cmain\u003e`-Element auf der Seite\nvoraus und einen Server, der jeden Anwendungspfad mit demselben HTML-Dokument\nbeantwortet. Die beiden Ansichten stehen für das, was die Anwendung tatsächlich\nanzeigt.\n\n```js\n// router.js\nconst views = {\n  \"/\": { title: \"Orders\", text: \"Your recent orders.\" },\n  \"/settings\": { title: \"Settings\", text: \"Delivery preferences.\" },\n};\nconst main = document.querySelector(\"main\");\n\nfunction show(path, moveFocus) {\n  const view = views[path] ?? views[\"/\"];\n  const heading = document.createElement(\"h1\");\n  const body = document.createElement(\"p\");\n  heading.textContent = view.title;\n  heading.tabIndex = -1;\n  body.textContent = view.text;\n  main.replaceChildren(heading, body);\n  document.title = view.title;\n  if (moveFocus) heading.focus();\n}\n\ndocument.addEventListener(\"click\", (event) =\u003e {\n  const link = event.target.closest(\"a[href]\");\n  const modified = event.metaKey || event.ctrlKey || event.shiftKey;\n  if (!link || link.origin !== location.origin) return;\n  if (modified || event.button !== 0) return;\n  event.preventDefault();\n  history.pushState(null, \"\", link.href);\n  show(location.pathname, true);\n});\n\nwindow.addEventListener(\"popstate\", () =\u003e show(location.pathname, true));\nshow(location.pathname, false);\n```\n\nDer Klick-Handler übernimmt einfache Linksklicks auf Links zum selben Origin\nund lässt modifizierte Klicks durch. Ein Link lässt sich deshalb weiterhin in\neinem neuen Tab öffnen. `preventDefault()` unterbindet die eigene Navigation\ndes Browsers, und `pushState()` trägt einen neuen Eintrag mit der Link-URL in\nden Sitzungsverlauf ein. Sein mittleres Argument existiert nur aus historischen\nGründen und ist deshalb eine leere Zeichenfolge. `show()` ersetzt die Ansicht,\nsetzt den Dokumenttitel und verschiebt den Fokus auf die neue Überschrift. Ein\n`tabIndex` von `-1` macht sie per Skript fokussierbar, hält sie aber aus der\nTab-Reihenfolge heraus. Der Listener für `popstate` zeichnet beim Zurück- oder\nVorwärtsgehen die passende Ansicht neu. Die letzte Zeile zeichnet die zur\nanfänglichen URL gehörende Ansicht. Das funktioniert nur, wenn der Server für\n`/settings` dasselbe Dokument wie für `/` sendet. Eine echte Anwendung würde\naußerdem eine eigene Nicht-gefunden-Ansicht zeigen, statt still auf die\nStartseite zurückzufallen, und Links zu Dateien und anderen Teilen der Website\nunangetastet lassen.\n\nIn der aktuellen Arbeit der Gründerin bei NextMariner zeigt das Frontend mit\nNext.js 16 diese Kosten an einem echten Produkt.\n[Der zugehörige Portfolioeintrag](/de/portfolio/built-the-next-js-16-frontend-ssr-ssg-and-csr/)\nbeschreibt ein Dashboard mit Anmeldung, das sich schnell anfühlen und wirklich\ninteraktiv bleiben musste. Er benennt auch, was passiert, wenn alle Daten im\nClient abgerufen werden: Der erste Ladevorgang zieht sich hin, und das\nN+1-Muster tritt auf. Jede Komponente wird aktiv und sendet ihre eigene Anfrage,\nbis eine einzelne Seite eine Kaskade von Hin- und Rückübertragungen auslöst.\nDamit begegnet einem in der Praxis genau die Kaskade clientseitiger Datenabrufe,\nvor der der Next.js-Leitfaden warnt. Die Lösung behielt clientseitige\nInteraktivität dort bei, wo sie wichtig war, und verlagerte den ersten\nDatenabruf auf den Server. Für das Dashboard und die großen Verzeichnislisten\nübergibt eine Factory namens `createPrefetchedServerPage` jede Seite mit bereits\nvorhandenen Daten an den Client. Der Eintrag benennt offen, was noch aussteht:\nDie übrigen Seiten mit Anmeldung werden weiterhin im Client gerendert und\nwarten, bis sie an der Reihe sind. Er beschreibt also eine funktionierende\nMigration, bei der die nächste umzustellende Seite klar ist, die aber noch nicht\nabgeschlossen ist.\n\n## Wo es schiefgeht\n\n**Die Zurück-Schaltfläche verlässt die Anwendung.** Tauscht ein Skript Ansichten\nohne `pushState()` aus, gibt es dafür keinen Eintrag im Sitzungsverlauf. Zurück\nüberspringt jede gesehene Ansicht und verlässt die Anwendung ganz. Ein Neuladen\nlandet bei der URL, mit der die Anwendung zuerst geöffnet wurde. Legen Sie für\njede Ansicht, die ein Leser als Seite verstehen würde, einen Eintrag an.\nVerwenden Sie `replaceState()` für Änderungen, die keine eigenen Schritte\nwerden sollen, etwa einen beim Tippen veränderten Filter, und behandeln Sie\n`popstate`. Next.js empfiehlt aus demselben Grund, den Routing-Zustand in der\nURL zu halten: So lässt sich eine Ansicht verlinken und teilen.\n\n**Ein Link auf eine Unterseite trifft auf einen Server, der nur eine Datei kennt.** In einer\nstrikten SPA bedient eine HTML-Datei jede Route. Die Adressleiste zeigt aber\n`/settings`, und genau das fordert der Browser beim Neuladen oder Öffnen eines\ngeteilten Links an. Ein Server mit nur einer `index.html` antwortet mit 404.\nKonfigurieren Sie ihn so, dass er jeden Anwendungspfad mit dem Dokument\nbeantwortet, oder erzeugen Sie eine Datei pro Route. Der statische Export von\nNext.js tut Letzteres: Sein Ordner `out` enthält Dateien wie `index.html`,\n`404.html` und `blog/post-1.html`. Der Leitfaden zeigt eine nginx-Regel,\n`try_files $uri $uri.html $uri/ =404;`, die eine saubere URL der passenden Datei\nzuordnet.\n\n**Der Fokus bleibt bei der alten Ansicht.** `pushState()` ändert den\nSitzungsverlauf und die URL, sonst nichts. Nach einem skriptgesteuerten\nAnsichtswechsel bleibt der Tastaturfokus auf dem angeklickten Link oder geht\nverloren, wenn sein Element entfernt wurde. Keine Meldung informiert assistive\nTechnik über die neue Ansicht, sofern die Seite das nicht selbst tut. Setzen Sie\nden Titel und verschieben Sie den Fokus wie im Beispiel auf die Überschrift\nder neuen Ansicht. Die Navigation API übernimmt davon mehr selbst. Eine mit\n`intercept()` behandelte Navigation setzt den Fokus standardmäßig auf das erste\nElement mit `autofocus`, andernfalls auf den Dokumentkörper. Nach Abschluss des\nHandlers meldet der Browser dem Nutzer den Abschluss. Nach dem Standard schließt\ndas assistive Technik ein. Eine Anwendung, die den Fokus selbst setzt, schaltet\ndas automatische Zurücksetzen mit `focusReset: \"manual\"` ab.\n\n**Alles wird im Voraus bezahlt.** Eine strikte SPA muss oft viel JavaScript\nladen, bevor irgendetwas interaktiv ist. Ihre ersten Datenanfragen beginnen\nerst, wenn dieser Code läuft. Teilen Sie das Bundle nach Routen auf, damit\nBesucher nur den für die aktuelle Ansicht benötigten Code laden, und beginnen\nSie die ersten Anfragen auf dem Server. Das Next.js-Muster dafür beginnt den Datenabruf in\neiner Server Component, ohne dessen Abschluss abzuwarten, und reicht das Promise an eine\nClient Component weiter. Diese entpackt es mit `use()`. Weil die Anfrage schon\nvor dem Rendern der restlichen Anwendung beginnt, kann laut Leitfaden sofort\ndie Übertragung der Antwort als Datenstrom beginnen. Dem Client bleibt eine Kaskade erspart, in der\njede Anfrage auf die vorherige wartet.\n\n## Weiterführende Lektüre\n\n- [Single-Page-Anwendungen mit Next.js bauen](https://nextjs.org/docs/app/guides/single-page-applications)\n  — Die Definition einer strikten SPA, ihre Kosten und Next.js-Muster, die\n  clientseitige Navigation beibehalten und Arbeit auf den Server verlagern.\n- [HTML Standard: die History-Schnittstelle](https://html.spec.whatwg.org/multipage/nav-history-apis.html#the-history-interface)\n  — `pushState()`, `replaceState()` und das Hinzufügen und Ersetzen von\n  Einträgen im Sitzungsverlauf.\n- [HTML Standard: Navigation API](https://html.spec.whatwg.org/multipage/nav-history-apis.html#navigation-api)\n  — Das Ereignis `navigate`, `intercept()` und die damit verbundene Fokus- und\n  Scrollsteuerung.\n- [Einen statischen Export einer Next.js-Anwendung erzeugen](https://nextjs.org/docs/app/guides/static-exports)\n  — Eine HTML-Datei pro Route, die Grenzen eines statischen Exports und das\n  Ausliefern sauberer URLs mit nginx.\n\n\u003chttps://engineer.company/de/glossary/single-page-application/\u003e\n","date_modified":"2026-11-09T21:50:25Z","description":"Ein HTML-Dokument, das JavaScript beim Navigieren umschreibt: die Browser-APIs dahinter, die Kosten und vier typische Fehler.","formats":{"gemtext":"https://engineer.company/de/glossary/single-page-application/index.gmi","gopher":"https://engineer.company/de/glossary/single-page-application/gophermap","html":"https://engineer.company/de/glossary/single-page-application/","json":"https://engineer.company/de/glossary/single-page-application/index.json","markdown":"https://engineer.company/de/glossary/single-page-application/index.md","pdf":"https://engineer.company/de/glossary/single-page-application/index.pdf"},"kind":"page","language":"de","title":"Was ist eine Single-Page-Anwendung?","url":"https://engineer.company/de/glossary/single-page-application/","version":1}