Naar de inhoud
OneKitly

JSON naar CSV omzetten: arrays van objecten platmaken tot rijen en kolommen

Gepubliceerd op 18-6-2025 · 4 min leestijd · Ontwikkelaarstools

Daniel Okonkwo

Daniel Okonkwo — Front-enddeveloper en techredacteur bij OneKitly

Webprestaties · Bestandsformaten

Getoetst aan 2 bronnen

Profiel bekijken →
Kort gezegd

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.

Advertentie

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.

JSON-naar-CSV-omzetterMaak van een JSON-array met objecten door komma's gescheiden waarden met een koprij. De tool neemt een heel bestand aan, zodat een lang logboek niet via het klembord hoeft.Probeer de tool →
Advertentie

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 →
UitlegcamelCase vs. snake_case: een gids voor naamgevingsconventies in codecamelCase, snake_case, PascalCase en kebab-case uitgelegd: hoe ze eruitzien, waar ze de conventie zijn en hoe je er consequent één kiest.UitlegCSV to JSON: The Five Cases That Break Every ConverterQuoted delimiters, embedded newlines, ambiguous types, duplicate headers and encoding. Each one was run through the converter and the exact output is printed here — including the two cases it does not rescue.UitlegXML to JSON: Attributes, Repetition, and the Single-Element Array TrapTwo documents that differ only in how many children exist produce two different JSON shapes, and no converter can tell them apart without a schema. Plus what this one really does with attributes, mixed content and whitespace — and the one thing it still cannot record.VergelijkingJSON vs XML: What's the Difference?JSON and XML both store structured data as text, but they trade off differently. Here's how each looks, where each wins, and how to choose.UitlegJSON to CSV When the Structure Is Nested: Why There Is No Right AnswerThe same two orders come out as five columns from one converter and ten from another, and neither is wrong. Dotted paths, arrays of scalars, arrays of objects and records with different keys — four decisions, made for you, usually silently.UitlegEscaping a String for JSON: Three Characters Are Mandatory, and One Is a TrapRFC 8259 requires exactly three things to be escaped inside a JSON string. Everything else is optional. The one that actually breaks pipelines is a lone surrogate — legal in JSON text, impossible in UTF-8, and silently replaced the moment your data is written out.

Vergelijkbare tools

Bronnen

Een fout in dit artikel gezien?