{"canonical_url":"https://engineer.company/nb/glossary/json/","content_markdown":"# JSON\n\n## Hva det er\n\nJSON er en ren tekstnotasjon for strukturerte data, skrevet med krøllparenteser, hakeparenteser,\ndoble anførselstegn og komma, slik at et program i nesten hvilket som helst språk kan lese tilbake\nnøyaktig det et annet program skrev. Bokstavene står for JavaScript Object Notation, fordi syntaksen\nble hentet fra måten JavaScript skriver litterale verdier på, men et JSON-dokument tilhører ikke noe\nspråk og trenger ingen JavaScript for å bli lest. Filer slutter som regel på `.json`, og over HTTP\nmerkes innholdet med medietypen `application/json`.\n\nHele formatet får plass på én side. Fire primitive typer (strenger, tall, litteralene `true` og\n`false`, og `null`) og to strukturerte utgjør vokabularet: et objekt, som er en uordnet mengde par\nav navn og verdi, og en tabell, array på engelsk, som er en ordnet liste. Alt kan nøstes inne i alt\nannet. Datoer, binære data, kommentarer og referanser mellom deler av et dokument er overlatt til\nkonvensjoner utenfor formatet.\n\nDouglas Crockford registrerte det første gang hos IETF i RFC 4627, i juli 2006. Den gjeldende\ndefinisjonen er RFC 8259 fra desember 2017, som er enig med Ecmas standard ECMA-404 om grammatikken\nog legger til reglene som betyr noe når to systemer utveksler JSON. Tekst som forlater et lukket\nøkosystem, må være UTF-8, og en avsender skal ikke sette et byte order mark foran den.\n\nXML er eldre og mer uttrykksfullt, med attributter, navnerom og en lang tradisjon av skjemaspråk.\nYAML ble revidert i versjon 1.2 for å bli en streng overmengde av JSON, med kommentarene og den\nlettere tegnsettingen folk vil ha i filer de redigerer for hånd. Binære kodinger som Protocol\nBuffers og CBOR bytter bort lesbarhet mot størrelse og fart.\n\n## Hvorfor det er viktig\n\nÅ velge JSON er egentlig å velge en kontrakt mellom to systemer: formen på det som går over\nledningen, og noen ganger formen på det som havner i lagringen.\n\nPå ledningen er det standardvalget fordi alt allerede snakker det. En nettleser parser det uten et\nbibliotek, hvert utbredt språk har en moden parser, og en utvikler som leser en logg, kan se hva en\nforespørsel hadde med seg. Kostnadene ligger andre steder. Hver post gjentar feltnavnene sine, tall\nreiser som desimaltekst som må parses tilbake, og formatet selv sier ingenting om hvilke felt som er\npåkrevd, eller hvilken type hvert felt har. En binær koding med skjemaet først, som Protocol\nBuffers, er mindre og raskere å parse, og kontrakten dens kontrolleres av en kompilator, men et\nmenneske trenger et verktøy for å lese én enkelt melding. For et offentlig API eller et som\nnettleseren snakker med, er JSON det fornuftige valget. Mellom interne tjenester der volum eller\nlatens veier tyngst, kan avveiningen gå den andre veien.\n\nEt skjema leverer som regel den manglende kontrakten. JSON Schema deklarerer hvilke egenskaper et\nobjekt må ha, hvilke typer de har, og om ekstra egenskaper er tillatt, og OpenAPI bygger på det for\nå beskrive hele HTTP-API-er. Et skjema er et eget dokument, og det forblir riktig bare så lenge noe\ntvinger det til å stemme med koden.\n\nI lagringen er spørsmålet om en struktur hører hjemme i en JSON-kolonne eller i ekte kolonner.\nPostgreSQL tilbyr to typer. `json` beholder en eksakt kopi av inndatateksten og parser den på nytt\nhver gang en funksjon rører den, mens `jsonb` lagrer en nedbrutt binær form som er litt tregere å\nskrive, mye raskere å spørre mot og kan indekseres; dokumentasjonen anbefaler `jsonb` for de fleste\napplikasjoner. En JSON-kolonne passer for data der formen varierer fra rad til rad eller tilhører\nklienten, som en brukers lagrede preferanser. Et felt databasen må koble på, begrense eller summere,\nfortjener en egen kolonne.\n\n## Slik ser det ut i praksis\n\nPå én plattform setter PostgreSQL-funksjonene selv sammen hvert komplette svar som JSON, og\nGo-API-et\n[sender den JSON-en urørt videre fra databasen til nettleseren](/nb/portfolio/designed-a-json-passthrough-from-postgres-to-api/).\nHandleren tar den imot som en `json.RawMessage` og sender den videre uten å dekode eller kode den på\nnytt, og en liten hjelper, `QueryJSON`, gjorde det til standardveien. DTO-ene, mappingkoden og\nrespons-structene i et lagdelt API falt bort. Når det en funksjon returnerer, endrer seg, når den\nnye formen klienten uten at noen redigerer handlerkoden.\n\nLagret JSON gir et annet problem, fordi den lever lenger enn koden som skrev den. En plattform\nlagrer varslingsinnstillinger og lignende preferanser som en brukers lagrede verdier lagt over et\nsett med standardverdier, opprinnelig slått sammen på ett nivå. En nøkkel som ble lagt til i\nstandardverdiene senere, manglet i hver rad som var lagret før den fantes, så klientkoden leste et\nudefinert felt og krasjet, og den krasjet for de brukerne som hadde vært med lengst. Løsningen var\n[en dyp sammenslåing som bruker standardverdiene som katalog](/nb/portfolio/implemented-a-catalogue-driven-deep-merge/):\nhver nøkkel i katalogen finnes i resultatet, nøstede nøkler inkludert, uansett hva den lagrede\nbloben inneholder. En databasemigrering brukte den på eksisterende rader med en gang, og frontenden\nkvittet seg med de defensive kontrollene sine.\n\nJSON er også rett og slett slik data kommer inn. For historiske strømdata levert som JSONL, én\nJSON-hendelse per linje, var oppgaven å gjøre rå hendelser om til forbruk per time og sone, og\n[det ble bygd tre varianter, i Python, JQ og SQL](/nb/portfolio/a-month-of-meter-readings-in-180-milliseconds/).\nPython var raskest, med 34 ms for én dags data og 180 ms for tretti dager.\n\n## Hvor det går galt\n\nGrammatikken er liten nok til at parserne er enige om hvordan gyldig tekst ser ut. Problemene kommer\nfra alt grammatikken lar stå åpent.\n\n**En stor ID kommer tilbake med ett siffer annerledes.** Grammatikken setter ikke noe tak på tall,\nmen de fleste parsere, også den i JavaScript, leser dem inn som 64-biters flyttall, som bare holder\nheltall eksakt opp til 2⁵³ − 1. RFC 8259 navngir området fra −(2⁵³ − 1) til 2⁵³ − 1 som det\nimplementasjonene er enige om. Utenfor det endrer identifikatorer seg uten noen advarsel:\n\n```js\nJSON.parse('{\"id\": 9007199254740993}').id;\n// 9007199254740992\n```\n\nSend 64-biters identifikatorer som strenger, og send pengebeløp som en streng eller som et heltall\nav den minste enheten, aldri som et flyttall.\n\n**To tjenester leser det samme objektet forskjellig.** RFC 8259 sier at navnene i et objekt bør være\nunike, og lar resten stå åpent: får de et gjentatt navn, beholder mange parsere den siste verdien,\nandre gir en feil, og noen returnerer hvert eneste par. Når en gateway sjekker den første `role` og\nbackenden handler på den andre, beskyttet sjekken ingenting. Avvis dupliserte navn der data kommer\ninn i systemet. I-JSON, definert i RFC 7493, er en profil av JSON som forbyr dem, og en kontrakt kan\nvise til den ved navn.\n\n**En fil som er redigert for hånd, slutter å kunne parses.** Kommentarer og avsluttende komma ligger\nutenfor grammatikken, så den første som kommenterer en konfigurasjonsfil, eller lar et komma stå\netter det siste elementet, ødelegger den. Noen verktøy godtar en løsere dialekt, og da blir den\nsamme filen gyldig for én leser og ødelagt for den neste. Bruk JSON til data som maskiner skriver,\nog gi filer som vedlikeholdes for hånd, et format laget for redigering, som YAML eller TOML.\n\n**Teksten kommer fram forvrengt, eller én parser avviser det en annen godtar.** RFC 8259 krever\nUTF-8 mellom systemer og forbyr et byte order mark i starten. En produsent som skriver Latin-1,\neller en editor som setter inn et slikt merke foran, gir tekst der utfallet avhenger av parseren.\nGrammatikken tillater også en escape som `\\uDEAD`, halvparten av et surrogatpar der partneren\nmangler, noe ingen gyldig Unicode-streng kan inneholde, og bibliotekene behandler det på ulike\nmåter. Kod som UTF-8 ved kilden og avvis ugyldige sekvenser ved grensen.\n\n**Én liten forespørsel binder opp parseren.** Noen få kilobyte med nøstede hakeparenteser kan drive\nen rekursiv parser tusenvis av nivåer ned, og en altfor stor body blir parset i sin helhet før noe\nskjema får se den. RFC 8259 lar en implementasjon begrense både tekststørrelsen og nøstedybden, og\net API som tar imot JSON fra fremmede, bør bruke begge: sett et tak på størrelsen på forespørselen\nfør den leses, sett et tak på dybden under parsingen, og sjekk formen først etter det.\n\n## Les mer\n\n- [RFC 8259: The JSON Data Interchange Format](https://www.rfc-editor.org/rfc/rfc8259) — den\n  gjeldende definisjonen fra IETF, med merknadene om tall, dupliserte navn og koding.\n- [ECMA-404: The JSON Data Interchange Syntax](https://ecma-international.org/publications-and-standards/standards/ecma-404/)\n  — Ecmas standard for den samme grammatikken, som RFC 8259 viser til som normativ.\n- [RFC 7493: The I-JSON Message Format](https://www.rfc-editor.org/rfc/rfc7493) — en strengere\n  profil som krever UTF-8 og forbyr dupliserte navn.\n- [JSON Schema-spesifikasjonen](https://json-schema.org/specification) — vokabularet for å deklarere\n  hvilke egenskaper et dokument må ha.\n- [PostgreSQL: JSON Types](https://www.postgresql.org/docs/current/datatype-json.html) — `json` mot\n  `jsonb`, og hva hver av dem beholder av den opprinnelige teksten.\n- [Go: json.RawMessage](https://pkg.go.dev/encoding/json#RawMessage) — typen som lar et Go-program\n  utsette dekodingen eller sende JSON urørt videre.\n\n\u003chttps://engineer.company/nb/glossary/json/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"Hva JSON kan uttrykke og hva det overlater til andre, når en jsonb-kolonne passer, og feilene store tall, dupliserte navn og dyp nøsting gir.","formats":{"gemtext":"https://engineer.company/nb/glossary/json/index.gmi","gopher":"https://engineer.company/nb/glossary/json/gophermap","html":"https://engineer.company/nb/glossary/json/","json":"https://engineer.company/nb/glossary/json/index.json","markdown":"https://engineer.company/nb/glossary/json/index.md","pdf":"https://engineer.company/nb/glossary/json/index.pdf"},"kind":"page","language":"nb","title":"Hva er JSON?","url":"https://engineer.company/nb/glossary/json/","version":1}