{"canonical_url":"https://engineer.company/nb/glossary/server-sent-events/","content_markdown":"# Server-sent events\n\n## Hva det er\n\nServer-sent events er en måte en webserver kan skyve meldinger ut til en side\npå, gjennom ett vanlig HTTP-svar som den holder åpent og skriver i hver gang det\ner noe nytt. De er definert i HTML-standarden, som WHATWG vedlikeholder, og den\nbeskriver både tekstformatet for strømmen og `EventSource`, grensesnittet i\nnettleseren som leser strømmen. Navnet forkortes ofte til SSE, og formatet\nkalles ofte etter medietypen sin, `text/event-stream`.\n\nEn side åpner en strøm med én linje, `new EventSource(url)`. Nettleseren sender\nen `GET`-forespørsel, som kan ha med seg `Accept: text/event-stream`, og\nforventer et svar med status 200 og den innholdstypen. Serveren sender\nheaderfeltene og gjør så ikke svaret ferdig. Hver gang noe skjer, skriver den\nnoen linjer tekst, og nettleseren gjør hver blokk med linjer om til en hendelse\nsom siden kan lytte etter.\n\nFormatet er bevisst enkelt. En strøm er alltid UTF-8, og hver linje er ett felt.\nEn `data`-linje bærer innholdet, og flere `data`-linjer etter hverandre settes\nsammen med linjeskift. En `event`-linje gir hendelsen en type, og uten den er\ntypen `message`. En `id`-linje setter ID-en til den siste hendelsen, og en\n`retry`-linje angir hvor mange millisekunder nettleseren venter før den\ngjenoppretter forbindelsen. En linje som begynner med kolon, er en kommentar,\nsom nettleseren ignorerer. En tom linje avslutter blokken og sender hendelsen av\nsted, så en blokk som blir avbrutt før den tomme linjen sin, blir kastet.\n\nGjenoppkobling er en del av standarden. Når forbindelsen brytes, venter\nnettleseren i gjenoppkoblingstiden, som starter på en verdi nettleseren selv\nvelger, ifølge standarden trolig noen sekunder, og sender så forespørselen på\nnytt. Har serveren gitt hendelsene sine ID-er, har den nye forespørselen med seg\nden siste av dem i et `Last-Event-ID`-headerfelt, og serveren kan fortsette\nderfra. Noen svar avslutter i stedet strømmen for godt: en annen status enn 200\neller en annen innholdstype får nettleseren til å gi opp og slutte å prøve, og\nstandarden peker ut 204 No Content som måten en server sier at strømmen er slutt\npå.\n\nRetningen går bare én vei. Etter den første forespørselen går ingenting fra\nsiden til serveren over den forbindelsen; når siden har noe å si, sender den en\negen HTTP-forespørsel.\n\n## Hvorfor det er viktig\n\nMange funksjoner som ser levende ut, trenger bare én retning: framdriften i en\nlang jobb, en ny melding, et tall på et dashbord, et svar som kommer i deler.\nUten en strøm må siden polle. Den spør med noen sekunders mellomrom, de fleste\nsvarene sier at ingenting er endret, og nyheter venter opptil et helt intervall\nfør noen ser dem. Med en strøm skriver serveren i samme øyeblikk som noe skjer.\n\nDet vanlige alternativet for å skyve data ut er WebSocket, som bytter\nforbindelsen over fra HTTP til en egen protokoll. Server-sent events holder seg\ni HTTP fra start til slutt, så de passerer de samme proxyene og lastbalansererne\nsom enhver annen forespørsel, de bruker de samme informasjonskapslene og de\nsamme reglene for forespørsler på tvers av opphav, og de kan dele én\nHTTP/2-forbindelse med resten av siden. Gjenoppkobling og gjenopptakelse fra den\nsiste hendelsen følger med nettleseren i stedet for å være kode hvert team\nskriver selv. WebSocket er fortsatt det riktige valget når klienten har like mye\nå si som serveren, som i en chat eller en delt editor.\n\nFormatet er heller ikke bundet til nettleseren. Enhver HTTP-klient kan lese det,\nog spesifikasjoner utenfor nettet bruker det. I Model Context Protocol, som\nAI-agenter kaller verktøy gjennom, lar transporten Streamable HTTP en server\nsvare på en forespørsel enten med ett JSON-objekt eller med et\n`text/event-stream`-svar. På den strømmen kan serveren sende varslinger og egne\nforespørsler før det endelige svaret, og den kan sette hendelses-ID-er på, slik\nat en klient som mister forbindelsen, kan fortsette med `Last-Event-ID`.\nStreamable HTTP erstattet HTTP+SSE, transporten i den tidligere\nprotokollversjonen 2024-11-05.\n\nBegrensningene er verdt å kjenne før man velger det. Strømmen bærer bare tekst,\nså binære data må først kodes som tekst. Nettleserens `EventSource`-konstruktør\ntar en URL og én innstilling, `withCredentials`, og ingenting annet, så en side\nkan ikke legge til et `Authorization`-headerfelt i forespørselen.\n\n## Slik ser det ut i praksis\n\nUtvekslingen nedenfor følger en lang eksportjobb. Nettleseren har mistet\nforbindelsen etter hendelse 41 og kobler seg til igjen, så forespørselen har med\nseg den ID-en, og serveren fortsetter fra hendelse 42:\n\n```http\nGET /jobs/4471/events HTTP/1.1\nHost: example.com\nAccept: text/event-stream\nLast-Event-ID: 41\n\nHTTP/1.1 200 OK\nContent-Type: text/event-stream\nCache-Control: no-store\n\nretry: 5000\n\n: still working\n\nid: 42\nevent: progress\ndata: {\"done\": 120, \"total\": 400}\n\nid: 43\nevent: progress\ndata: {\"done\": 400, \"total\": 400}\n\nid: 44\nevent: finished\ndata: {\"report\": \"/jobs/4471/report.pdf\"}\n\n```\n\n`retry`-linjen ber nettleseren vente fem sekunder før hver senere\ngjenoppkobling, og kommentarlinjen bærer ingen hendelse i det hele tatt; den er\nder for å holde forbindelsen i aktivitet mens jobben er stille. Siden lytter\netter de to hendelsestypene ved navn:\n\n```js\nconst source = new EventSource(\"/jobs/4471/events\");\nsource.addEventListener(\"progress\", (event) =\u003e {\n  const { done, total } = JSON.parse(event.data);\n  showProgress(done / total);\n});\nsource.addEventListener(\"finished\", (event) =\u003e {\n  showReport(JSON.parse(event.data).report);\n  source.close();\n});\nsource.addEventListener(\"error\", () =\u003e {\n  if (source.readyState === EventSource.CLOSED) showRetryButton();\n});\n```\n\nKallet til `close()` betyr noe. Når serveren avslutter et svar på vanlig måte,\nbehandler nettleseren det som en brutt forbindelse og kobler seg til igjen, så\nen strøm for en ferdig jobb ellers ville åpnet seg igjen etter fem sekunder.\n`error`-handleren skiller mellom de to typene feil: så lenge `readyState` er\n`CONNECTING`, prøver nettleseren fortsatt, og når den er `CLOSED`, har den gitt\nopp.\n\nArbeid som fortsetter etter at agenten har fått svaret sitt, er et av temaene på\nsiden om [programvaren din som verktøy for AI-agenter](/nb/ai-tools/) her på\nnettstedet. Den beskriver hvordan hver operasjon en agent skal ha tilgang til,\ntilbys som et verktøy, med en MCP-server som tilbyr de samme operasjonene til\nagenter som bruker MCP, og hvordan tidkrevende jobber legges i en kø, så agenten\nfår et svar mens arbeidet pågår. I MCP-spesifikasjonen kan en server bruke en\nhendelsesstrøm som den ovenfor til å sende egne forespørsler eller varslinger\nfør det endelige svaret på klientens forespørsel.\n\n## Hvor det går galt\n\n**Hendelser som kommer i klumper, eller alle til slutt.** Noe mellom serveren og\nnettleseren holder svaret tilbake. nginx, for eksempel, bufrer som standard\nsvarene fra serveren bak seg og sender bare et svar videre etter hvert som det\nkommer, når bufring er slått av. HTML-standarden advarer også om at\nHTTP-chunking utført av et lag som ikke vet noe om timingen i strømmen, kan\ngjøre den upålitelig. Slå av bufring for strømmens location, i nginx med\n`proxy_buffering off` eller med headerfeltet `X-Accel-Buffering: no` i svaret,\ntøm skrivebufferen etter hver hendelse i serverkoden, og test gjennom hele\nveien, proxy medregnet, i stedet for mot serveren alene.\n\n**Stille strømmer som blir kuttet av en timeout.** En proxy som ikke ser en\neneste byte på en stund, går ut fra at forbindelsen er død. I nginx er\nstandardverdien for `proxy_read_timeout` 60 sekunder mellom to lesinger, og\nderetter blir forbindelsen lukket, og HTML-standarden advarer om at noen eldre\nproxyer bryter forbindelser etter en kort timeout. Den foreslår en\nkommentarlinje omtrent hvert 15. sekund, som koster noen få byte, og som\nnettleseren ignorerer.\n\n**Hendelser som går tapt ved en gjenoppkobling.** Nettleseren sender bare\n`Last-Event-ID` hvis serveren har gitt hendelsene sine ID-er, og headerfeltet\nhjelper bare hvis serveren fortsatt kan finne det som kom etter den ID-en. Gi\nhver hendelse en ID som fungerer som en markør i strømmen, behold et vindu med\nnylige hendelser som kan spilles av på nytt, og send hele den gjeldende\ntilstanden når en ID er for gammel å fortsette fra. MCP-spesifikasjonen legger\ntil en regel som er verdt å kopiere: ID-er hører til én strøm, og en server må\nikke spille av meldinger på nytt på én strøm når de var ment for en annen.\n\n**Gjenoppkobling som aldri stopper, eller stopper for godt.** En strøm som\nslutter normalt, kommer tilbake etter gjenoppkoblingstiden, igjen og igjen, så\nen ferdig jobb fortsetter å åpne strømmen sin på nytt med mindre siden kaller\n`close()` eller serveren svarer på gjenoppkoblingen med 204. Det motsatte skjer\nunder en utrulling. En proxy som svarer 502 eller 503 mens serverne starter på\nnytt, gir hver åpen `EventSource` en annen status enn 200, og hver eneste av dem\nstopper for godt. Lytt etter `error`, og når `readyState` er `CLOSED`, opprett\nen ny `EventSource` etter en tilfeldig forsinkelse som vokser for hver feil.\n\n**For mange strømmer til én nettleser.** Nettlesere begrenser hvor mange\nforbindelser de holder åpne til én server, og en strøm over HTTP/1.1 opptar en\nav dem så lenge den varer. HTML-standarden advarer om at et nettsted der hver\nåpen side har sin egen `EventSource`, kan møte den grensen. Lever strømmen over\nHTTP/2, der strømmer deler én forbindelse, og RFC 9113 anbefaler å tillate minst\n100 om gangen, eller del én `EventSource` mellom fanene gjennom en shared\nworker.\n\n**Tokenet i adressen.** Fordi `EventSource` ikke kan sende et\n`Authorization`-headerfelt, er den raske løsningen et token i URL-en, der\nreverse proxyer og tilgangslogger skriver det ned. Autentiser strømmen med\nsesjonens informasjonskapsel, som siden allerede har, og legg til\n`withCredentials` når strømmen kommer fra et annet opphav, eller med en\nkortlivet engangsbillett som siden henter med en autentisert forespørsel rett\nfør den åpner strømmen.\n\n## Les mer\n\n- [HTML Standard: Server-sent events](https://html.spec.whatwg.org/multipage/server-sent-events.html)\n  — formatet for strømmen, `EventSource`-grensesnittet, gjenoppkobling og\n  standardens merknader til forfattere om proxyer og grenser for antall\n  forbindelser.\n- [Transports - Model Context Protocol](https://modelcontextprotocol.io/specification/2025-06-18/basic/transports)\n  — Streamable HTTP, der en server kan svare med en hendelsesstrøm, og hvordan\n  en avbrutt strøm blir gjenopptatt.\n- [RFC 9113: HTTP/2](https://www.rfc-editor.org/rfc/rfc9113) — strømmer som\n  deler én forbindelse, og innstillingen som begrenser hvor mange som kan være\n  åpne samtidig.\n- [nginx: Module ngx_http_proxy_module](https://nginx.org/en/docs/http/ngx_http_proxy_module.html)\n  — `proxy_buffering`, headerfeltet `X-Accel-Buffering` og `proxy_read_timeout`.\n\n\u003chttps://engineer.company/nb/glossary/server-sent-events/\u003e\n","date_modified":"2026-11-09T21:50:25Z","description":"Hvordan en server holder ett HTTP-svar åpent og skriver hendelser i det, hva nettleseren gjør når forbindelsen brytes, og proxyene som holder dem tilbake.","formats":{"gemtext":"https://engineer.company/nb/glossary/server-sent-events/index.gmi","gopher":"https://engineer.company/nb/glossary/server-sent-events/gophermap","html":"https://engineer.company/nb/glossary/server-sent-events/","json":"https://engineer.company/nb/glossary/server-sent-events/index.json","markdown":"https://engineer.company/nb/glossary/server-sent-events/index.md","pdf":"https://engineer.company/nb/glossary/server-sent-events/index.pdf"},"kind":"page","language":"nb","title":"Hva er server-sent events?","url":"https://engineer.company/nb/glossary/server-sent-events/","version":1}