{"canonical_url":"https://engineer.company/nb/glossary/single-page-application/","content_markdown":"# Single-page application\n\n## Hva det er\n\nEn single-page application, også kalt enkeltsideapp og som regel forkortet til\nSPA, er en webapplikasjon som laster inn ett HTML-dokument og deretter endrer\ndet dokumentet med JavaScript i stedet for å be serveren om en ny side. Et klikk\npå en lenke inne i den får ikke nettleseren til å forlate siden. Et skript\nfanger opp klikket, henter de dataene neste visning trenger, skriver om en del\nav DOM-en og oppdaterer adresselinjen, slik at URL-en fortsatt forteller hvor\nleseren er.\n\nIngen standard eier begrepet, og de som lager verktøyene, sier det selv. Next.js\nåpner veiledningen sin om emnet med «The definition of a SPA varies.» og\nfastsetter deretter en definisjon til eget bruk, som Next.js kaller en strict\nSPA. Den har to kjennetegn. Appen leveres av én HTML-fil, og hver rute, hver\nsideovergang og hver datahenting håndteres av JavaScript i nettleseren. Og det\ner ingen fullstendige omlastinger av siden: i stedet for å be om et nytt\ndokument for hver rute endrer JavaScript på klienten DOM-en til den gjeldende\nsiden og henter data etter behov. Denne artikkelen bruker den definisjonen fordi\nden er den mest direkte som finnes, og fordi den nevner egenskapen alt annet\navhenger av, nemlig et dokument som aldri blir byttet ut.\n\nNettleserdelene er standardiserte. History-grensesnittet i HTML-standarden gir\nen side `history.pushState()`, som legger til en ny oppføring i økthistorikken\nog setter URL-en uten å laste inn noe, og `history.replaceState()`, som i stedet\nskriver om den gjeldende oppføringen. Når leseren går tilbake eller fram mellom\ndisse oppføringene, sender nettleseren en `popstate`-hendelse til vinduet og\noverlater til siden å tegne innholdet på nytt. Det nyere Navigation API, som\nstandarden presenterer som etterfølgeren til de klassiske location- og\nhistory-API-ene, arbeider fra den andre enden: en `navigate`-hendelse utløses\nnår en navigasjon begynner, og metoden `intercept()` gjør navigasjonen om til en\nnavigasjon innenfor det samme dokumentet, som siden håndterer selv.\n\nDet motsatte er det vanlige nettstedet med flere sider, der hver lenke ber\nserveren om et nytt dokument og nettleseren kaster det gamle. Om HTML-en til en\nside blir laget én gang av en statisk nettstedsgenerator eller ved hver\nforespørsel med server-side rendering, er et annet spørsmål. Det handler om\nhvordan HTML-en blir til, og ikke om hva som skjer når den har kommet fram.\nNext.js visker ut grensen med vilje. En statisk eksport fra Next.js skriver en\nHTML-fil for hver rute, og overgangen mellom dem skjer fortsatt på klienten.\n\n## Hvorfor det er viktig\n\nFordi dokumentet aldri blir byttet ut, overlever alt som ligger i det, et klikk:\net halvt utfylt skjema, en video som spilles av, rulleposisjonen i et sidepanel,\ndata som allerede er hentet. Bare dataene neste visning trenger, må over\nnettverket, og ikke en hel ny side der toppen, stilarkene og skriptene følger\nmed på nytt. Et bytte av visning kan være så lite som å skrive om ett område av\nsiden.\n\nNext.js nevner kostnadene i samme åndedrag som definisjonen. En strict SPA må\nofte laste inn store mengder JavaScript før siden kan bli interaktiv, og\nkaskader av forespørsler på klienten, der én forespørsel først kan starte når en\nannen har kommet tilbake, er vanskelige å styre. Alt som leser siden uten å\nkjøre skript, betaler også. Med én HTML-fil bak hver rute får en søkerobot som\nikke kjører JavaScript, det samme nesten tomme dokumentet uansett hvilken URL\nden ber om. Next.js sier det samme om sine egne komponenter som bare kjører i\nnettleseren: søkeroboter som ikke kjører JavaScript, ser fallbacken i stedet for\nkomponenten.\n\nSvaret fra Next.js er å beholde navigasjonen på klienten og flytte resten.\nNext.js deler automatisk opp JavaScript-bundlene og genererer flere\nHTML-inngangspunkter til forskjellige ruter, slik at en besøkende ikke laster\ninn kode en rute ikke trenger. Komponenten `next/link` forhåndshenter ruter, noe\nsom gir de raske sideovergangene fra en strict SPA og samtidig holder\napplikasjonens rutingtilstand i URL-en, der den kan lenkes til og deles. En\nstatisk eksport går et steg videre og skriver en ferdig rendret side for hver\nrute, slik at besøkende får innhold uten å vente på klientens bundle, mens\noverganger mellom sider på klienten forblir like raske som i en strict SPA.\n\nValget tas heller ikke én gang for alle. Next.js beskriver et prosjekt som\nstarter som et statisk nettsted, eller til og med som en strict SPA som rendres\nhelt på klienten, og som får serverfunksjoner etter hvert som det vokser, og\nifølge Next.js kan eksisterende SPA-er migreres uten å skrives helt om.\n\n## Slik ser det ut i praksis\n\nRuteren nedenfor er skrevet for denne artikkelen og er den minste versjonen av\nideen som fungerer. Den forutsetter at siden har et `\u003cmain\u003e`-element, og at\nserveren svarer på hver sti i appen med det samme HTML-dokumentet. De to\nvisningene står for det appen egentlig viser.\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\nKlikkhåndtereren tar over vanlige venstreklikk på lenker til samme origin og\nslipper gjennom klikk med modifikatortaster, slik at det fortsatt går an å åpne\nen lenke i en ny fane. `preventDefault()` stopper nettleserens egen navigasjon,\nog `pushState()` registrerer en ny oppføring i økthistorikken med lenkens URL.\nDet midterste argumentet finnes bare av historiske grunner, og derfor er det en\ntom streng. `show()` bytter ut visningen, setter dokumentets tittel og flytter\nfokus til den nye overskriften, som en `tabIndex` på `-1` gjør fokuserbar fra\nskript, mens den holdes utenfor tabulatorrekkefølgen. Lytteren på `popstate`\ntegner den tilsvarende visningen på nytt når leseren går tilbake eller fram, og\nden siste linjen tegner den URL-en siden ble åpnet på, noe som bare fungerer\nhvis serveren sender det samme dokumentet for `/settings` som for `/`. En ekte\napp ville også vise sin egen side for adresser den ikke kjenner, i stedet for å\nfalle stille tilbake til startsiden, og den ville la lenker til filer og til\nandre deler av nettstedet være i fred.\n\nI grunnleggerens nåværende arbeid hos NextMariner viser Next.js 16-frontenden\nkostnadssiden av dette på et ekte produkt.\n[Porteføljesiden om frontenden](/nb/portfolio/built-the-next-js-16-frontend-ssr-ssg-and-csr/)\nbeskriver et innlogget dashbord som skulle føles raskt og samtidig være virkelig\ninteraktivt, og forteller hva som skjer når alt hentes på klienten: den første\ninnlastingen blir treg, og N+1-mønsteret dukker opp, der hver komponent sender\nsin egen forespørsel når den våkner, helt til én side er blitt en kaskade av\nrundturer. Det er nettopp kaskaden av forespørsler på klienten som\nNext.js-veiledningen advarer mot, her møtt i praksis. Løsningen beholdt\ninteraktiviteten på klientsiden der den betydde noe, og flyttet den første\ndatahentingen over på serveren. På dashbordet og de store katalogoversiktene gir\nen fabrikk som heter `createPrefetchedServerPage`, hver side videre til klienten\nmed dataene allerede på plass. Siden legger ikke skjul på resten: de andre\ninnloggede sidene rendres fortsatt på klienten og venter på tur, så den\nbeskriver en migrering som virker og har en opplagt neste kandidat, og ikke en\nsom er fullført.\n\n## Hvor det går galt\n\n**Tilbake-knappen forlater appen.** Hvis et skript bytter visning uten å kalle\n`pushState()`, har økthistorikken ingen oppføring for visningene. Tilbake hopper\nover hver visning leseren har sett, og forlater appen helt, og en omlasting\nlander på den URL-en appen først ble åpnet på. Legg til en oppføring for hver\nvisning en leser ville kalt en side, bruk `replaceState()` til endringer som\nikke skal bli egne steg, som et filter som er i ferd med å bli skrevet inn, og\nhåndter `popstate`. Next.js argumenterer for å holde rutingtilstanden i URL-en\nav samme grunn: det er den som gjør det mulig å lenke til en visning og dele\nden.\n\n**En lenke rett til en underside møter en server som bare kjenner én fil.** I en\nstrict SPA betjener én HTML-fil hver rute, men adresselinjen viser `/settings`,\nog det er den adressen nettleseren ber om ved en omlasting, eller når noen åpner\nen delt lenke. En server som bare har `index.html`, svarer med en 404.\nKonfigurer enten serveren til å svare på hver sti i appen med dokumentet, eller\ngenerer en fil per rute. Den statiske eksporten i Next.js gjør det siste:\n`out`-mappen inneholder filer som `index.html`, `404.html` og\n`blog/post-1.html`, og veiledningen viser en nginx-regel,\n`try_files $uri $uri.html $uri/ =404;`, som kobler en pen URL til den\ntilsvarende filen.\n\n**Fokuset blir værende der den gamle visningen var.** `pushState()` endrer\nøkthistorikken og URL-en og ingenting annet. Når et skript har byttet visningen,\nblir tastaturfokuset værende på lenken som ble klikket, eller går tapt hvis\nelementet som hadde det, ble fjernet, og ingenting forteller\nhjelpemiddelteknologi at en ny visning har kommet, med mindre siden gjør det.\nSett tittelen, og flytt fokus til overskriften i den nye visningen, slik\neksemplet gjør. Navigation API tar på seg mer av dette arbeidet selv. En\nnavigasjon som håndteres med `intercept()`, nullstiller som standard fokus til\ndet første elementet med `autofocus` eller ellers til body, og når håndtereren\ner ferdig, signaliserer nettleseren til brukeren at navigasjonen er fullført,\nnoe som ifølge standarden også omfatter hjelpemiddelteknologi. En app som\nplasserer fokus selv, velger det bort med `focusReset: \"manual\"`.\n\n**Alt betales på forhånd.** En strict SPA må ofte laste inn store mengder\nJavaScript før noe er interaktivt, og de første dataforespørslene starter først\nnår den koden kjører. Del opp bundlen etter rute, slik at en besøkende bare\nlaster ned det den gjeldende visningen trenger, og start de første forespørslene\npå serveren. Mønsteret i Next.js henter data i en Server Component uten å vente\npå dem og sender promiset videre til en Client Component, som pakker det ut med\n`use()`. Når forespørselen starter før resten av appen rendres, kan svaret\nifølge veiledningen strømmes med en gang, og kaskader av forespørsler på\nklienten unngås.\n\n## Les mer\n\n- [How to build single-page applications with Next.js](https://nextjs.org/docs/app/guides/single-page-applications)\n  — definisjonen av en strict SPA, hva den koster, og mønstrene Next.js bruker\n  for å beholde navigasjonen på klienten og flytte arbeid over på serveren.\n- [HTML Standard: The History interface](https://html.spec.whatwg.org/multipage/nav-history-apis.html#the-history-interface)\n  — `pushState()`, `replaceState()` og hvordan oppføringer i økthistorikken\n  legges til og byttes ut.\n- [HTML Standard: Navigation API](https://html.spec.whatwg.org/multipage/nav-history-apis.html#navigation-api)\n  — `navigate`-hendelsen, `intercept()` og håndteringen av fokus og rulling som\n  følger med.\n- [How to create a static export of your Next.js application](https://nextjs.org/docs/app/guides/static-exports)\n  — én HTML-fil per rute, hva en statisk eksport ikke kan, og pene URL-er med\n  nginx.\n\n\u003chttps://engineer.company/nb/glossary/single-page-application/\u003e\n","date_modified":"2026-11-09T21:50:25Z","description":"Ett HTML-dokument som JavaScript skriver om mens leseren beveger seg rundt: nettleser-API-ene bak, hva det koster, og fire måter det går galt på.","formats":{"gemtext":"https://engineer.company/nb/glossary/single-page-application/index.gmi","gopher":"https://engineer.company/nb/glossary/single-page-application/gophermap","html":"https://engineer.company/nb/glossary/single-page-application/","json":"https://engineer.company/nb/glossary/single-page-application/index.json","markdown":"https://engineer.company/nb/glossary/single-page-application/index.md","pdf":"https://engineer.company/nb/glossary/single-page-application/index.pdf"},"kind":"page","language":"nb","title":"Hva er en single-page application?","url":"https://engineer.company/nb/glossary/single-page-application/","version":1}