{"canonical_url":"https://engineer.company/sv/glossary/json/","content_markdown":"# JSON\n\n## Vad det är\n\nJSON är en textnotation för strukturerade data, skriven med klammerparenteser, hakparenteser,\ndubbla citattecken och kommatecken, så att ett program i nästan vilket språk som helst kan läsa\ntillbaka exakt det som ett annat program skrev. Bokstäverna står för JavaScript Object Notation,\neftersom syntaxen togs från det sätt som JavaScript skriver literala värden på, men ett\nJSON-dokument tillhör inget språk och behöver ingen JavaScript för att läsas. Filer slutar oftast\npå `.json`, och över HTTP märks innehållet med medietypen `application/json`.\n\nHela formatet får plats på en sida. Fyra primitiva typer (strängar, tal, literalerna `true` och\n`false`, och `null`) och två strukturerade utgör ordförrådet: ett objekt, som är en oordnad mängd\npar av namn och värde, och en array, som är en ordnad lista. Vad som helst kan nästlas inuti vad\nsom helst annat. Datum, binärdata, kommentarer och referenser mellan delar av ett dokument lämnas\nalla åt konventioner utanför formatet.\n\nDouglas Crockford registrerade det först hos IETF i RFC 4627, i juli 2006. Den gällande\ndefinitionen är RFC 8259 från december 2017, som stämmer överens med Ecmas standard ECMA-404 om\ngrammatiken och lägger till de regler som spelar roll när två system utbyter det. Text som lämnar\nett slutet ekosystem måste vara UTF-8, och en avsändare får inte lägga en byteordningsmarkering\nframför den.\n\nXML är äldre och uttrycksfullare, med attribut, namnrymder och en lång tradition av schemaspråk.\nYAML reviderades i version 1.2 för att bli en strikt övermängd av JSON och lägger till de\nkommentarer och den lättare interpunktion som folk vill ha i filer som de redigerar för hand.\nBinära kodningar som Protocol Buffers och CBOR byter läsbarhet mot storlek och hastighet.\n\n## Varför det spelar roll\n\nAtt välja JSON är egentligen att välja ett kontrakt mellan två system: formen på det som går över\ntråden, och ibland formen på det som hamnar i lagringen.\n\nPå tråden är det förvalet eftersom allt redan talar det. En webbläsare tolkar det utan bibliotek,\nvarje etablerat språk har en mogen parser, och en ingenjör som läser en logg kan se vad en begäran\ninnehöll. Kostnaderna ligger på andra ställen. Varje post upprepar sina fältnamn, tal färdas som\ndecimaltext som måste tolkas tillbaka, och formatet självt säger ingenting om vilka fält som\nkrävs eller vilken typ vart och ett har. En binär kodning där schemat kommer först, som Protocol\nBuffers, är mindre och snabbare att tolka, och dess kontrakt kontrolleras av en kompilator, men en\nmänniska behöver ett verktyg för att läsa ett enda meddelande. För ett publikt API, eller ett som\nvänder sig mot webbläsare, är JSON det förnuftiga valet. Mellan interna tjänster där volym eller\nlatens dominerar kan avvägningen gå åt andra hållet.\n\nEtt schema står oftast för det kontrakt som saknas. JSON Schema deklarerar vilka egenskaper ett\nobjekt måste ha, vilka typer de har och om extra egenskaper är tillåtna, och OpenAPI bygger på det\nför att beskriva hela HTTP-API:er. Ett schema är ett separat dokument, och det förblir korrekt\nbara så länge något tvingar det att stämma med koden.\n\nI lagringen är frågan om en struktur hör hemma i en JSON-kolumn eller i riktiga kolumner.\nPostgreSQL erbjuder två typer. `json` behåller en exakt kopia av indatatexten och tolkar om den\nvarje gång en funktion rör den, medan `jsonb` lagrar en uppdelad binär form som är något\nlångsammare att skriva, mycket snabbare att fråga mot och kan indexeras; dokumentationen\nrekommenderar `jsonb` för de flesta applikationer. En JSON-kolumn passar data vars form varierar\nfrån rad till rad eller tillhör klienten, t.ex. en användares sparade inställningar. Ett fält som\ndatabasen måste joina på, begränsa eller summera förtjänar en egen kolumn.\n\n## Så ser det ut i praktiken\n\nPå en plattform sätter PostgreSQL-funktionerna själva ihop varje komplett svar som JSON, och\nAPI:et i Go\n[skickar den JSON-koden orörd vidare från databasen till webbläsaren](/sv/portfolio/designed-a-json-passthrough-from-postgres-to-api/).\nHandlern tar emot den som en `json.RawMessage` och lämnar den vidare utan att avkoda eller koda om\nden, och en liten hjälpfunktion, `QueryJSON`, gjorde det till förvalet. DTO:erna,\nmappningsfunktionerna och svars-structarna i ett lagerindelat API föll bort. När utdata från en\nfunktion ändras når den nya formen klienten utan någon ändring i handlerkoden.\n\nLagrad JSON för med sig ett annat problem, eftersom den överlever koden som skrev den. En\nplattform sparar aviseringsinställningar och liknande som en användares sparade värden lagda\novanpå en uppsättning standardvärden, ursprungligen sammanslagna på en enda nivå. En nyckel som\nlades till i standardvärdena senare saknades i varje rad som sparats innan den fanns, så\nklientkoden läste ett odefinierat fält och kraschade, och den kraschade för de användare som hade\nvarit med längst. Lösningen var\n[en djup sammanslagning som behandlar standardvärdena som en katalog](/sv/portfolio/implemented-a-catalogue-driven-deep-merge/):\nvarje nyckel i katalogen finns med i resultatet, nästlade nycklar inräknade, oavsett vad den\nsparade bloben innehåller. En migrering tillämpade den på befintliga rader direkt, och frontenden\nkunde släppa sina defensiva kontroller.\n\nJSON är också helt enkelt den form som data anländer i. För historiska eldata som levererades som\nJSONL, en JSON-händelse per rad, var uppgiften att göra om råa händelser till förbrukning per\ntimme och zon, och\n[tre varianter byggdes, i Python, JQ och SQL](/sv/portfolio/a-month-of-meter-readings-in-180-milliseconds/).\nPython var snabbast, med 34 ms för en dags data och 180 ms för trettio dagar.\n\n## Var det går fel\n\nGrammatiken är så liten att parsrar är överens om hur giltig text ser ut. Problemen kommer från\nallt som grammatiken lämnar öppet.\n\n**Ett stort id kommer tillbaka med en siffra annorlunda.** Grammatiken sätter inget tak för tal,\nmen de flesta parsrar, JavaScripts bland dem, läser in dem som 64-bitars flyttal, som rymmer heltal\nexakt bara upp till 2⁵³ − 1. RFC 8259 anger intervallet från −(2⁵³ − 1) till 2⁵³ − 1 som det som\nimplementationerna är överens om. Bortom det ändras identifierare utan någon varning:\n\n```js\nJSON.parse('{\"id\": 9007199254740993}').id;\n// 9007199254740992\n```\n\nSkicka 64-bitars identifierare som strängar, och skicka pengar som en sträng eller som ett heltal\nav den minsta enheten, aldrig som ett flyttal.\n\n**Två tjänster läser samma objekt olika.** RFC 8259 säger att namnen i ett objekt bör vara unika\noch lämnar resten öppet: vid ett upprepat namn behåller många parsrar det sista värdet, andra\nsignalerar ett fel och några lämnar tillbaka varje par. När en gateway kontrollerar den första\n`role` och backend agerar på den andra skyddade kontrollen ingenting. Avvisa dubblerade namn där\ndata kommer in i systemet. I-JSON, definierat i RFC 7493, är en profil av JSON som förbjuder dem,\noch ett kontrakt kan hänvisa till den vid namn.\n\n**En handredigerad fil går inte längre att tolka.** Kommentarer och avslutande kommatecken ligger\nutanför grammatiken, så den första som kommenterar en konfigurationsfil, eller lämnar ett komma\nefter sista posten, förstör den. Vissa verktyg accepterar en friare dialekt, vilket gör samma fil\ngiltig för en läsare och trasig för nästa. Använd JSON för data som maskiner skriver, och ge filer\nsom underhålls för hand ett format gjort för redigering, som YAML eller TOML.\n\n**Texten kommer fram förvanskad, eller en parser avvisar det som en annan accepterar.** RFC 8259\nkräver UTF-8 mellan system och förbjuder en byteordningsmarkering i början. En producent som\nskriver Latin-1, eller en editor som lägger till en markering först, ger text vars öde beror på\nparsern. Grammatiken tillåter också en escape-sekvens som `\"\\uDEAD\"`, ena halvan av ett\nsurrogatpar där partnern saknas, som ingen giltig Unicode-sträng kan rymma, och bibliotek hanterar\nden på olika sätt. Koda som UTF-8 vid källan och avvisa ogiltiga sekvenser vid gränsen.\n\n**En liten begäran binder upp parsern.** Några kilobyte nästlade hakparenteser kan driva en\nrekursiv parser tusentals nivåer ned, och en överstor kropp tolkas i sin helhet innan något schema\nser den. RFC 8259 låter en implementation begränsa både textens storlek och nästlingsdjupet, och\nett API som tar emot JSON från okända avsändare bör använda båda: begränsa storleken på begäran\ninnan den läses, begränsa djupet under tolkningen och kontrollera formen först efter det.\n\n## Läs mer\n\n- [RFC 8259: The JSON Data Interchange Format](https://www.rfc-editor.org/rfc/rfc8259) — IETF:s\n  gällande definition, med anmärkningarna om tal, dubblerade namn och teckenkodning.\n- [ECMA-404: The JSON Data Interchange Syntax](https://ecma-international.org/publications-and-standards/standards/ecma-404/)\n  — Ecmas standard för samma grammatik, som RFC 8259 hänvisar till som normativ.\n- [RFC 7493: The I-JSON Message Format](https://www.rfc-editor.org/rfc/rfc7493) — en striktare\n  profil som kräver UTF-8 och förbjuder dubblerade namn.\n- [JSON Schema specification](https://json-schema.org/specification) — ordförrådet för att\n  deklarera vilka egenskaper ett dokument måste ha.\n- [PostgreSQL: JSON Types](https://www.postgresql.org/docs/current/datatype-json.html) — `json`\n  mot `jsonb`, och vad var och en behåller av den ursprungliga texten.\n- [Go: json.RawMessage](https://pkg.go.dev/encoding/json#RawMessage) — typen som låter ett\n  Go-program skjuta upp avkodningen eller skicka JSON vidare orörd.\n\n\u003chttps://engineer.company/sv/glossary/json/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"Hur JSON fungerar, när ett API eller en databaskolumn bör använda det och vilka fällor med dubblerade nycklar, stora tal och teckenkodning som väntar.","formats":{"gemtext":"https://engineer.company/sv/glossary/json/index.gmi","gopher":"https://engineer.company/sv/glossary/json/gophermap","html":"https://engineer.company/sv/glossary/json/","json":"https://engineer.company/sv/glossary/json/index.json","markdown":"https://engineer.company/sv/glossary/json/index.md","pdf":"https://engineer.company/sv/glossary/json/index.pdf"},"kind":"page","language":"sv","title":"Vad är JSON?","url":"https://engineer.company/sv/glossary/json/","version":1}