JSON formatteren & valideren

Andermans JSON lezen zonder gek te worden

De meeste JSON die je in de praktijk tegenkomt was nooit bedoeld voor mensenogen: een API-respons komt binnen als één enorme regel, een configuratiebestand is door een build-stap geminimaliseerd, of een logregel heeft er een payload in geperst. De gewoonte die loont is simpel — eerst plakken, dan lezen. Zodra hij geformatteerd is, laat de inspringing je meteen de vorm van de data zien voordat je ook maar één waarde leest: hoe diep de nesting gaat, welke delen arrays van herhaalde dingen zijn en welke eenmalige instellingen. Die blik op de structuur beantwoordt de vraag vaak al vanzelf, omdat het veld waar je naar op zoek was blijkt te zitten in een ander object dan je dacht. Er verandert niets aan de data zelf als je formatteert — alleen de witruimte — dus de geformatteerde kopie kun je gewoon terugplakken waar hij vandaan kwam.

Als de JSON geldig is maar er toch verkeerd uitziet

Twee dingen zorgen ook ná een geslaagde parse regelmatig voor verwarring. Het eerste is JSON in JSON: een stringveld waarvan de waarde zelf een brok geëscapete JSON is, vol backslash-en-aanhalingsteken-paren. Dat is geen corruptie — een systeem heeft ergens een document als tekst opgeslagen binnen een ander document. Kopieer de binnenste string eruit en formatteer die apart om hem te lezen. Het tweede zijn grote getallen. JSON zelf staat gehele getallen van elke grootte toe, maar JavaScript slaat getallen op als 64-bit floats, waardoor een ID van meer dan zo'n vijftien of zestien cijfers stilzwijgend zijn laatste cijfers kan veranderen bij het parsen. Komt een geformatteerde payload er met een subtiel afwijkend lang numeriek ID uit, dan is dit de reden — en het is precies waarom goed ontworpen API's lange ID's als strings versturen.

Waar Minify eigenlijk voor dient

Geminimaliseerde JSON is bedoeld voor machines en krappe ruimtes: een payload die je in een curl-commando plakt, een waarde die je in een omgevingsvariabele of één databasekolom perst, een respons die je zo klein mogelijk over de lijn wilt sturen. Formatteren en minifyen zijn perfecte spiegelbeelden van elkaar — je kunt dezelfde data de hele dag heen en weer laten kaatsen tussen de twee en er verandert nooit iets anders dan de witruimte. Een opgeruimde workflow gebruikt beide: formatteren om te lezen en bewerken, minifyen om te versturen. En als je data ooit als spreadsheet begon in plaats van als JSON, zet de CSV naar JSON-converter de rijen om in een array van objecten — het resultaat hier plakken is een snelle manier om te bevestigen dat hij parset voordat je code hem ooit te zien krijgt.

De klassieke boosdoeners wanneer JSON niet wil parsen

JSON is strenger dan JavaScript: sleutels moeten tussen dubbele aanhalingstekens staan, geen komma achter het laatste item, geen commentaar, en enkele aanhalingstekens mogen nergens. De validator hier draait terwijl je typt en vertelt je de regel en kolom van het eerste probleem dat hij tegenkomt.