Veelvoorkomende JSON-syntaxisfouten begrijpen en direct oplossen

1. Waarom JSON een meedogenloos strikte syntaxis heeft

JSON (JavaScript Object Notation) is de universele lingua franca van moderne web-API's, microservices, configuratiebestanden en NoSQL-databases. Hoewel de syntaxis is afgeleid van JavaScript-objectliterals, is de officiële specificatie (vastgelegd in RFC 8259 en ECMA-404) vele malen strenger dan JavaScript zelf.

Waar een JavaScript-engine soepel omgaat met ontbrekende aanhalingstekens, trailing commas of commentaarregels, zal een standaard JSON-parser (zoals JSON.parse() in Node.js of json.loads() in Python) onmiddellijk crashen met een fatale foutmelding zodra er een enkele komma of quote ontbreekt.

2. De 5 meest voorkomende JSON-syntaxisfouten

Vrijwel alle parsingproblemen in productie zijn te herleiden tot de volgende vijf klassieke vergissingen:

Fout 1: De beruchte "Trailing Comma" (overtollige komma aan het einde)

In moderne JavaScript, TypeScript en Python is een komma na het laatste element van een array of object toegestaan. In strikt JSON is dit echter categorisch verboden:

// FOUTIEF:
{
  "naam": "GoToolstack",
  "versie": 2.4,
}

// CORRECT:
{
  "naam": "GoToolstack",
  "versie": 2.4
}

Fout 2: Enkele aanhalingstekens in plaats van dubbele aanhalingstekens

In JSON moeten zowel alle object-sleutels (keys) als alle tekstwaarden (strings) verplicht omsloten worden door dubbele aanhalingstekens ("). Enkele aanhalingstekens (') of backticks (`) zijn ongeldig:

// FOUTIEF:
{ 'status': 'actief' }

// CORRECT:
{ "status": "actief" }

Fout 3: Commentaarregels toevoegen in standaard JSON

Standaard JSON ondersteunt geen commentaarregels (zoals // comment of /* comment */). Als u configuratiebestanden van commentaar wilt voorzien, moet u gebruikmaken van formaten zoals JSONC, YAML of TOML, of commentaar opnemen als reguliere data-eigenschappen (bijvoorbeeld "_comment": "...").

Fout 4: Ongeëscapete controletekens in strings

Reële regeleinden (line breaks) of tabulators mogen niet letterlijk in een JSON-string voorkomen. Ze moeten correct geëscapet worden met \n, \r of \t:

// FOUTIEF:
{ "beschrijving": "Regel een
Regel twee" }

// CORRECT:
{ "beschrijving": "Regel een\nRegel twee" }

Fout 5: Ontbrekende komma's tussen eigenschappen

Wanneer u handmatig regels toevoegt aan een JSON-bestand, wordt de scheidende komma aan het einde van de voorgaande regel vaak over het hoofd gezien:

// FOUTIEF:
{
  "id": 101
  "actief": true
}

// CORRECT:
{
  "id": 101,
  "actief": true
}

3. RFC 8259: wat mag wel en wat mag absoluut niet?

Conform RFC 8259 kent JSON slechts zes basistypen:

• Object: Een ongeordende verzameling sleutel-waardeparen omsloten door accolades { }.
• Array: Een geordende lijst van waarden omsloten door rechte haken [ ].
• String: Unicode-tekst omsloten door dubbele aanhalingstekens "...".
• Number: Decimale getallen (inclusief wetenschappelijke notatie zoals 1.5e3). Speciale waarden zoals NaN, Infinity of -Infinity zijn strikt verboden.
• Boolean: Exact de kleine letters true of false.
• Null: Exact de kleine letters null. Ongedefinieerde waarden (zoals JavaScript void 0) bestaan niet in JSON.

4. Getallen, precisie en veilige gehele getallen (64-bit)

Hoewel RFC 8259 geen vaste limiet stelt aan de grootte van getallen, hanteren vrijwel alle JavaScript-engines en web-API's de IEEE 754 dubbele-precisie standaard (64-bit float). Dit betekent dat gehele getallen groter dan Number.MAX_SAFE_INTEGER (9.007.199.254.740.991 of 2^53 - 1) precisieverlies kunnen oplopen bij het parsen.

Voorbeeld: een 64-bit database-ID zoals 18446744073709551615 wordt in JavaScript afgerond naar 18446744073709552000. Zend grote 64-bit identificaties of exacte monetaire bedragen daarom altijd als string ("18446744073709551615") mee in uw payloads.

5. Snel debuggen met de GoToolstack JSON Formatter

De GoToolstack JSON Formatter biedt een interactieve ontwikkelomgeving die syntaxisfouten direct in uw browser lokaliseert:

1. Plak uw code: Plak uw ruwe of verhaspelde JSON-tekst direct in het editorvenster.
2. Realtime parserfoutmeldingen: Zodra er een syntaxisfout aanwezig is, markeert de ingebouwde linter exact het regel- en kolomnummer met een duidelijke uitleg.
3. Eén-klik opschonen: Klik op "Formatteren" om de data netjes in te springen (2 of 4 spaties) of op "Minify" om alle overbodige witruimte te verwijderen voor productiegebruik.