{"canonical_url":"https://engineer.company/sv/glossary/single-page-application/","content_markdown":"# Single-page application\n\n## Vad det är\n\nEn single-page application, även kallad ensidesapp och oftast förkortad SPA, är\nen webbapplikation som läser in ett HTML-dokument och sedan ändrar det\ndokumentet med JavaScript i stället för att be servern om en ny sida. Ett klick\npå en länk inuti den får inte webbläsaren att lämna sidan. Ett skript fångar\nklicket, hämtar de data som nästa vy behöver, skriver om en del av DOM:en och\nuppdaterar adressfältet, så att URL:en fortfarande talar om var läsaren befinner\nsig.\n\nIngen standard äger begreppet, och de som bygger verktygen säger det själva.\nNext.js inleder sin guide i ämnet med ”The definition of a SPA varies.” och slår\nsedan fast en definition för eget bruk, som Next.js kallar en strict SPA. Den\nhar två kännetecken. Appen levereras av en enda HTML-fil, och varje route, varje\nsidbyte och varje datahämtning hanteras av JavaScript i webbläsaren. Och det\nsker inga fullständiga omladdningar av sidan: i stället för att begära ett nytt\ndokument för varje route ändrar JavaScript på klienten den aktuella sidans DOM\noch hämtar data vid behov. Den här artikeln använder den definitionen eftersom\nden är den mest direkta som finns och eftersom den pekar ut egenskapen som allt\nannat hänger på, nämligen ett dokument som aldrig byts ut.\n\nWebbläsardelarna är standardiserade. HTML-standardens History-gränssnitt ger en\nsida `history.pushState()`, som lägger till en ny post i sessionshistoriken och\nsätter URL:en utan att läsa in något, och `history.replaceState()`, som i\nstället skriver om den aktuella posten. När läsaren går bakåt eller framåt\nmellan posterna skickar webbläsaren en `popstate`-händelse till fönstret och\növerlåter åt sidan att rita om innehållet. Det nyare Navigation API, som\nstandarden presenterar som efterföljaren till de klassiska location- och\nhistory-API:erna, arbetar från andra hållet: en `navigate`-händelse utlöses när\nen navigering börjar, och dess metod `intercept()` gör navigeringen till en\nnavigering inom samma dokument, som sidan hanterar själv.\n\nMotsatsen är den vanliga webbplatsen med flera sidor, där varje länk ber servern\nom ett nytt dokument och webbläsaren kastar det gamla. Om en sidas HTML-kod\nskapas en gång av en statisk webbplatsgenerator eller vid varje förfrågan med\nserver-side rendering är en annan fråga. Den handlar om hur HTML-koden kommer\ntill, inte om vad som händer när den väl har kommit fram. Next.js suddar ut\ngränsen med flit. En statisk export från Next.js skriver en HTML-fil för varje\nroute, och bytet mellan dem sker fortfarande på klienten.\n\n## Varför det spelar roll\n\nEftersom dokumentet aldrig byts ut överlever allt som finns i det ett klick: ett\nhalvt ifyllt formulär, en video som spelas, scrollpositionen i en sidopanel,\ndata som redan har hämtats. Bara de data som nästa vy behöver måste över\nnätverket, och inte en hel ny sida där sidhuvud, stilmallar och skript följer\nmed på nytt. Ett byte av vy kan vara så litet som att skriva om ett område på\nsidan.\n\nNext.js nämner kostnaderna i samma andetag som definitionen. En strict SPA måste\nofta läsa in en stor mängd JavaScript innan sidan kan bli interaktiv, och\nkaskader av förfrågningar på klienten, där en förfrågan kan börja först när en\nannan har kommit tillbaka, är svåra att hantera. Allt som läser sidan utan att\nköra skript får också betala. Med en enda HTML-fil bakom varje route får en\nsökrobot som inte kör JavaScript samma nästan tomma dokument, oavsett vilken URL\nden ber om. Next.js säger samma sak om sina egna komponenter som bara körs i\nwebbläsaren: sökrobotar som inte kör JavaScript ser fallbacken i stället för\nkomponenten.\n\nSvaret från Next.js är att behålla navigeringen på klienten och flytta resten.\nNext.js delar automatiskt upp JavaScript-bundlarna och genererar flera\nHTML-ingångar till olika routes, så att en besökare inte läser in kod som en\nroute inte behöver. Komponenten `next/link` förhämtar routes, vilket ger de\nsnabba sidbytena från en strict SPA och samtidigt håller applikationens\nroutingtillstånd i URL:en, där det går att länka till och dela. En statisk\nexport går ett steg längre och skriver en färdigrenderad sida för varje route,\nså att besökare får innehåll utan att vänta på klientens bundle, medan byten\nmellan sidor på klienten förblir lika snabba som i en strict SPA.\n\nValet görs inte heller en gång för alla. Next.js beskriver ett projekt som\nbörjar som en statisk webbplats, eller till och med som en strict SPA som\nrenderas helt på klienten, och som får serverfunktioner allteftersom det växer,\noch enligt Next.js kan befintliga SPA:er migreras utan att skrivas om helt.\n\n## Så ser det ut i praktiken\n\nRoutern nedan är skriven för den här artikeln och är den minsta fungerande\nversionen av idén. Den förutsätter att sidan har ett `\u003cmain\u003e`-element och att\nservern svarar på varje sökväg i appen med samma HTML-dokument. De två vyerna\nstår för det som appen egentligen visar.\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\nKlickhanteraren tar över vanliga vänsterklick på länkar till samma origin och\nsläpper igenom klick med modifieringstangenter, så att det fortfarande går att\nöppna en länk i en ny flik. `preventDefault()` stoppar webbläsarens egen\nnavigering, och `pushState()` registrerar en ny post i sessionshistoriken med\nlänkens URL. Det mellersta argumentet finns bara av historiska skäl, och därför\när det en tom sträng. `show()` byter ut vyn, sätter dokumentets titel och\nflyttar fokus till den nya rubriken, som en `tabIndex` på `-1` gör fokuserbar\nfrån skript, medan den hålls utanför tabbordningen. Lyssnaren på `popstate`\nritar om den matchande vyn när läsaren går bakåt eller framåt, och den sista\nraden ritar den URL som sidan öppnades på, vilket bara fungerar om servern\nskickar samma dokument för `/settings` som för `/`. En riktig app skulle också\nvisa en egen sida för adresser den inte känner till, i stället för att i tysthet\nfalla tillbaka till startsidan, och den skulle låta länkar till filer och till\nandra delar av webbplatsen vara.\n\nI grundarens nuvarande arbete för NextMariner visar frontenden i Next.js 16\nkostnadssidan av det här på en riktig produkt.\n[Portfoliosidan om frontenden](/sv/portfolio/built-the-next-js-16-frontend-ssr-ssg-and-csr/)\nbeskriver en dashboard för inloggade användare som skulle kännas snabb och\nförbli genuint interaktiv, och berättar vad som händer när allt hämtas på\nklienten: den första laddningen blir seg, och N+1-mönstret dyker upp, där varje\nkomponent skickar sin egen förfrågan när den vaknar, tills en enda sida har\nblivit en kaskad av rundresor. Det är just den kaskad av förfrågningar på\nklienten som Next.js-guiden varnar för, här i praktiken. Lösningen behöll\ninteraktiviteten på klientsidan där den spelade roll och flyttade den första\ndatahämtningen till servern. På dashboarden och de stora katalogsidorna lämnar\nen fabrik som heter `createPrefetchedServerPage` över varje sida till klienten\nmed data redan på plats. Sidan sticker inte under stol med resten: de övriga\nsidorna för inloggade användare renderas fortfarande på klienten och väntar på\nsin tur, så den beskriver en migrering som fungerar och har en given nästa\nkandidat, inte en som är avslutad.\n\n## Var det går fel\n\n**Bakåtknappen lämnar appen.** Om ett skript byter vy utan att anropa\n`pushState()` har sessionshistoriken ingen post för vyerna. Bakåt hoppar över\nvarje vy som läsaren har sett och lämnar appen helt, och en omladdning hamnar på\nden URL som appen först öppnades på. Lägg till en post för varje vy som en\nläsare skulle kalla en sida, använd `replaceState()` för ändringar som inte ska\nbli egna steg, till exempel ett filter som håller på att skrivas in, och hantera\n`popstate`. Next.js argumenterar för att hålla routingtillståndet i URL:en av\nsamma skäl: det är det som gör det möjligt att länka till en vy och dela den.\n\n**En direktlänk till en undersida möter en server som bara känner till en fil.**\nI en strict SPA betjänar en enda HTML-fil varje route, men adressfältet visar\n`/settings`, och det är den adressen webbläsaren ber om vid en omladdning eller\nnär någon öppnar en delad länk. En server som bara har `index.html` svarar med\nen 404. Konfigurera antingen servern så att den svarar på varje sökväg i appen\nmed dokumentet, eller generera en fil per route. Den statiska exporten i Next.js\ngör det senare: dess `out`-mapp innehåller filer som `index.html`, `404.html`\noch `blog/post-1.html`, och guiden visar en nginx-regel,\n`try_files $uri $uri.html $uri/ =404;`, som kopplar en snygg URL till den\nmatchande filen.\n\n**Fokus stannar där den gamla vyn var.** `pushState()` ändrar sessionshistoriken\noch URL:en och ingenting annat. När ett skript har bytt vy stannar\ntangentbordsfokus på länken som klickades, eller går förlorat om elementet som\nhade det togs bort, och ingenting talar om för hjälpmedel att en ny vy har\nkommit, om inte sidan gör det. Sätt titeln och flytta fokus till den nya vyns\nrubrik, som exemplet gör. Navigation API tar själv på sig mer av det arbetet. En\nnavigering som hanteras med `intercept()` återställer som standard fokus till\ndet första elementet med `autofocus` eller annars till body, och när hanteraren\när klar signalerar webbläsaren till användaren att navigeringen är slutförd,\nvilket enligt standarden också omfattar hjälpmedel. En app som själv placerar\nfokus väljer bort det med `focusReset: \"manual\"`.\n\n**Allt betalas i förväg.** En strict SPA måste ofta läsa in en stor mängd\nJavaScript innan något är interaktivt, och dess första dataförfrågningar startar\nförst när den koden körs. Dela upp bundlen per route, så att en besökare bara\nladdar ner det som den aktuella vyn behöver, och starta de första\nförfrågningarna på servern. Mönstret i Next.js hämtar data i en Server Component\nutan att invänta dem och skickar promiset vidare till en Client Component, som\npackar upp det med `use()`. När förfrågan startar innan resten av appen renderas\nkan svaret enligt guiden strömmas direkt, och kaskader av förfrågningar på\nklienten undviks.\n\n## Läs mer\n\n- [How to build single-page applications with Next.js](https://nextjs.org/docs/app/guides/single-page-applications)\n  — definitionen av en strict SPA, vad den kostar och de mönster som Next.js\n  använder för att behålla navigeringen på klienten och flytta arbete till\n  servern.\n- [HTML Standard: The History interface](https://html.spec.whatwg.org/multipage/nav-history-apis.html#the-history-interface)\n  — `pushState()`, `replaceState()` och hur poster i sessionshistoriken läggs\n  till och byts ut.\n- [HTML Standard: Navigation API](https://html.spec.whatwg.org/multipage/nav-history-apis.html#navigation-api)\n  — `navigate`-händelsen, `intercept()` och den hantering av fokus och scroll\n  som följer med.\n- [How to create a static export of your Next.js application](https://nextjs.org/docs/app/guides/static-exports)\n  — en HTML-fil per route, vad en statisk export inte kan, och snygga URL:er med\n  nginx.\n\n\u003chttps://engineer.company/sv/glossary/single-page-application/\u003e\n","date_modified":"2026-11-09T21:50:25Z","description":"Ett HTML-dokument som JavaScript skriver om medan läsaren klickar sig fram: API:erna i webbläsaren, vad det kostar och fyra sätt det går fel på.","formats":{"gemtext":"https://engineer.company/sv/glossary/single-page-application/index.gmi","gopher":"https://engineer.company/sv/glossary/single-page-application/gophermap","html":"https://engineer.company/sv/glossary/single-page-application/","json":"https://engineer.company/sv/glossary/single-page-application/index.json","markdown":"https://engineer.company/sv/glossary/single-page-application/index.md","pdf":"https://engineer.company/sv/glossary/single-page-application/index.pdf"},"kind":"page","language":"sv","title":"Vad är en single-page application?","url":"https://engineer.company/sv/glossary/single-page-application/","version":1}