Je build faalt met "Unexpected token in JSON at position 4,821." Geweldig, bedankt. Nu mag je door een configuratiebestand van vierduizend tekens scrollen om in je hoofd haakjes te tellen en te achterhalen welke niet klopt. Dit is een van de meest vermijdbare tijdverspillers in softwareontwikkeling, en het gebeurt voortdurend omdat JSON geen enkele tolerantie heeft voor kleine fouten.
Een slotkomma na het laatste item in een array. Een ontbrekend aanhalingsteken rond een key. Een extra sluitende accolade die ergens anders vandaan gekopieerd is. Elk hiervan breekt het parsen volledig, en de foutmelding wijst zelden naar het echte probleem — hij wijst naar waar de parser opgaf, wat vaak meerdere regels verwijderd is van de eigenlijke fout.
Waarom positienummers niet helpen
De meeste JSON-parsers rapporteren fouten als een tekenoffset, niet als een regel en kolom waar je in je editor naartoe kunt springen. Positie 4.821 omzetten naar "regel 112, ergens bij het derde object" vereist ofwel handmatig tellen ofwel een wegwerpscript schrijven. Geen van beide is een goede besteding van je middag.
Sommige editors markeren JSON-syntaxfouten inline, wat helpt bij bestanden die je actief aan het schrijven bent. Maar voor JSON die je van een API, een collega, of een geërfde legacy-configuratie hebt gekregen, heb je een tool nodig die de ruwe tekst neemt en je precies vertelt wat er mis is en waar.
Valideer JSON zonder je Mac te verlaten
Een JSON-formatter die ook valideert, bespaart je het giswerk. Plak de JSON erin, en als deze misvormd is, krijg je een duidelijke foutmelding die naar de specifieke regel en het teken wijst in plaats van een ruwe byte-offset. Als het geldig is, wordt het netjes weergegeven met correcte inspringing, zodat je de structuur visueel kunt doorlopen. Bellows handelt beide gevallen af in dezelfde tool — je hoeft van tevoren niet te weten of je JSON kapot is.
Fouten opvangen voordat ze uitgerold worden
Configuratiebestanden, API-requestbodies en fixture-data staan of vallen bij geldige JSON. Een snelle validatieronde uitvoeren voordat je een configuratiewijziging commit of een testverzoek verstuurt, vangt precies het soort typefout op dat anders veel later in de pipeline als een verwarrende runtime-fout naar boven zou komen.
Werken met niet-vertrouwde invoer
Wanneer een collega je een JSON-blob in Slack plakt, of je haalt er een uit een externe API die je niet volledig vertrouwt, betekent lokaal valideren dat je nooit die data naar een externe website hoeft te sturen alleen om te controleren of hij parseert.