JSON formatteren en valideren

Zo gebruik je de JSON-formatter

1. Plak je JSON in het invoervak.
2. Kies een Inspringing: 2 spaties, 4 spaties of een tab. Zet Sleutels sorteren aan als je de sleutels van objecten in alfabetische volgorde wilt.
3. Klik op Formatteren (beautify) om de JSON netjes op te maken, of op Minifyen om hem tot één regel samen te persen.
4. Is de JSON ongeldig, lees dan de foutmelding met de regel en kolom van het probleem, verbeter het en probeer het opnieuw.
5. Kopieer het resultaat en gebruik het in je code, documentatie of API-client.

Wat deze tool doet

JSON (JavaScript Object Notation) is het meest gebruikte formaat om gegevens uit te wisselen tussen webservices, en voor configuratiebestanden. Ruwe JSON uit een API is vaak één dichte regel die moeilijk te lezen is. Deze tool maakt hem leesbaar, controleert of hij geldig is, en kan hem weer verkleinen als je een compacte versie nodig hebt.

• Formatteren (beautify): voegt regeleinden en consistente inspringing toe, zodat de nesting van objecten en arrays makkelijk te volgen is. Je kunt inspringen met 2 spaties, 4 spaties of tabs, passend bij de stijl van je project.
• Minifyen: haalt alle overbodige witruimte weg en levert de kleinst mogelijke geldige JSON op, handig voor payloads, om in code in te sluiten of om bestanden kleiner te maken.
• Valideren: controleert of je invoer goed gevormde JSON is. Zo niet, dan toont de tool de syntaxfout met regel en kolom, zodat je hem snel vindt.
• Sleutels sorteren: zet de sleutels van elk object op alfabetische volgorde. Grote objecten zijn dan makkelijker door te nemen, en twee JSON-documenten zijn veel makkelijker naast elkaar te vergelijken.

Veelvoorkomende JSON-fouten

Mislukt de validatie, dan is de oorzaak meestal een van deze:

• Komma aan het eind: {"a": 1,} is geen geldige JSON, ook al staan veel programmeertalen het toe.
• Enkele aanhalingstekens: strings en sleutels in JSON moeten dubbele aanhalingstekens gebruiken. {'name': 'Ana'} is ongeldig.
• Sleutels zonder aanhalingstekens: {name: "Ana"} is geldig JavaScript, maar geen geldige JSON.
• Commentaar: standaard-JSON staat geen //- of /* */-commentaar toe.
• Ontbrekende komma’s of haakjes: een vergeten komma tussen twee items of een niet-gesloten } of ].
• Speciale waarden: undefined, NaN en Infinity maken geen deel uit van JSON.

De regel en kolom in de foutmelding wijzen naar de plek waar de parser het probleem opmerkte. De echte fout zit soms net daarvoor, bijvoorbeeld een ontbrekende komma aan het eind van de vorige regel. De uitleg achter de dubbele punt komt van de JSON-parser van je browser en is meestal in het Engels.

Veilig voor gevoelige gegevens

Formatteren, minifyen en valideren gebeuren allemaal lokaal in je browser. Je JSON wordt nooit naar een server gestuurd. Dat is belangrijk, want JSON bevat vaak gevoelige informatie: API-antwoorden met klantgegevens, toegangstokens, interne configuratiebestanden of logs. Met deze tool blijven die gegevens op je eigen computer.