JSON naar CSV omzetten: arrays van objecten platmaken tot rijen en kolommen
Gepubliceerd op 18-6-2025 · 4 min leestijd · Ontwikkelaarstools
Daniel Okonkwo — Front-enddeveloper en techredacteur bij OneKitly
Webprestaties · Bestandsformaten
Getoetst aan 2 bronnen
Begin bij het omzetten van JSON naar CSV met een array van objecten. Verzamel de vereniging van alle sleutels tot de kopregel en schrijf daarna één regel per object, waarbij je elk veld in de volgorde van de kopregel leest. Zet elke waarde met een komma, een dubbel aanhalingsteken of een regeleinde tussen dubbele aanhalingstekens en verdubbel de aanhalingstekens die erin staan. Geneste objecten en arrays moet je eerst platmaken tot kolommen in puntnotatie, zoals address.city.
Een praktische gids om een JSON-array van objecten om te zetten naar een net CSV-bestand, met uitleg over het platmaken van geneste velden en de lastige randgevallen.
Waarom de vorm van je JSON uitmaakt
CSV is een plat, tweedimensionaal formaat: rijen en kolommen, niets meer. JSON is een boom die objecten in objecten en arrays in arrays kan nesten. Het schone geval voor een omzetting is een array van objecten op het hoogste niveau, waarin elk object een rij wordt en elke sleutel een kolom. Alles wat dieper zit, moet je eerst hervormen voordat het in een raster past.
Omdat verschillende objecten verschillende sleutels kunnen bevatten, moet de kopregel de vereniging zijn van alle sleutels die je tegenkomt, niet alleen die van het eerste object. Lees je alleen het eerste record, dan verdwijnen latere kolommen geruisloos en raakt het bestand uit de pas.
Geneste objecten en arrays platmaken
De standaardtruc is puntnotatie. Een object als {"address":{"city":"Lagos"}} wordt een kolom address.city met de waarde Lagos. Nesten mag zo diep als je wilt: user.address.city is volkomen geldig. Arrays krijgen een index op positie, dus tags met ["api","web"] wordt twee kolommen: tags.0 en tags.1.
Platmaken werkt goed zolang arrays kort zijn en een vaste lengte hebben. Kan een array groeien, dan ontploft het aantal geïndexeerde kolommen: één record met vijftig tags levert vijftig kolommen op. Dan is het vaak netter om de array als één samengevoegde tekenreeks te bewaren, bijvoorbeeld "api;web;csv", of om de gegevens in een tweede, gerelateerde tabel te zetten.
Randgevallen waarop naïeve omzetters stuklopen
De meest voorkomende fout zit in de aanhalingstekens. Bevat een waarde het scheidingsteken (meestal een komma), een dubbel aanhalingsteken of een regeleinde, dan moet ze tussen dubbele aanhalingstekens staan en moet elk dubbel aanhalingsteken erin verdubbeld worden. De waarde She said "hi" wordt dus "She said ""hi""". Sla je dat over, dan raakt elke rij verderop beschadigd.
Andere valkuilen: null tegenover een lege tekenreeks (beide worden meestal een lege cel), booleans en getallen die een spreadsheet opnieuw kan interpreteren (een code met een voorloopnul zoals 007 kan zijn nullen kwijtraken) en de tekenset. Schrijf altijd UTF-8 en overweeg een byte order mark aan het begin als het bestand ook in oudere spreadsheetprogramma's netjes moet openen.
Veelgestelde vragen
- Wat als mijn JSON één object is en geen array?
- Zet het in een array, dan krijg je een CSV van één rij. Wil je liever elke sleutel op zijn eigen regel, transponeer het dan naar een indeling met twee kolommen: key,value.
- Welk scheidingsteken gebruik ik, een komma of een puntkomma?
- De komma is de standaard in de CSV-norm. Sommige regionale spreadsheetinstellingen verwachten een puntkomma; staan er al komma's in je waarden, dan kan een puntkomma of een tab het aantal aanhalingstekens beperken.
- Hoe voorkom ik dat voorloopnullen verdwijnen?
- De nullen staan wél in het CSV-bestand; een spreadsheet gooit ze weg zodra die de kolom als getal behandelt. Importeer de kolom als tekst, anders herformatteert de spreadsheet hem bij het openen.
- Kan ik de CSV weer terug omzetten naar JSON?
- Deels. Platte kolommen komen netjes terug, maar sleutels in puntnotatie moet je opnieuw nesten, en CSV verliest de type-informatie: getallen en booleans komen als tekenreeks terug tenzij je ze opnieuw parseert.
Artikelen die je misschien interesseren
Alle gidsen →Vergelijkbare tools
Bronnen
Een fout in dit artikel gezien?