JSON Formázó & Validáló hibák javításához

Egyetlen hiányzó vessző vagy idézőjel is elég ahhoz, hogy egy alkalmazás, adatimport vagy beállítási fájl hibával leálljon. A JSON Formázó & Validáló erre ad gyors, érthető választ: áttekinthetővé rendezi az adatokat, és megmutatja, ha a szerkezet nem érvényes.

A JSON gyakori formátum webes szolgáltatások, API-k, exportált adatok és alkalmazásbeállítások esetén. Nem kell fejlesztőnek lennie ahhoz, hogy találkozzon vele: előfordulhat webshopos termékadatoknál, űrlapok integrációjánál, automatizált munkafolyamatoknál vagy egy online rendszerből letöltött fájlban is. Ilyenkor egy böngészőben használható ellenőrző eszköz sok felesleges próbálkozást takaríthat meg.

Mire használható egy JSON Formázó & Validáló?

A formázás és a validálás két külön feladat, de a gyakorlatban együtt a leghasznosabbak. A formázó tagolja a nehezen olvasható, egy sorba került adatot: behúzásokat és sortöréseket alkalmaz, így láthatóvá válik, melyik érték melyik objektumhoz tartozik. A validáló ezzel szemben azt ellenőrzi, hogy a szöveg megfelel-e a JSON szabályainak.

Például ez a rövid JSON nehezen áttekinthető egyetlen sorban:

```json {"nev":"Kiss Anna","varos":"Szeged","aktiv":true} ```

Formázva gyorsabban ellenőrizhető:

```json { "nev": "Kiss Anna", "varos": "Szeged", "aktiv": true } ```

A tartalom nem változik, csak olvashatóbb lesz. Ez különösen akkor számít, ha több tucat mezőt, egymásba ágyazott adatokat vagy hosszú listákat kell átnézni.

A leggyakoribb JSON-hibák

A JSON szigorú formátum. Sokszor olyan apróság miatt érvénytelen, amely első pillantásra fel sem tűnik. A validálás célja nem az, hogy bonyolult technikai magyarázatot adjon, hanem hogy a hibát minél közelebb mutassa meg annak helyéhez.

Gyakori probléma, hogy valaki egyszeres idézőjelet használ a szöveges kulcsok vagy értékek körül. A JSON-ban dupla idézőjel szükséges. Hasonlóan gyakori a lista vagy objektum utolsó eleme után bent maradt vessző. Sok programozási nyelv ezt bizonyos helyzetekben elfogadja, a szabványos JSON viszont nem.

Hibát okozhat az is, ha a logikai értékeket nagybetűvel írják. A `true`, `false` és `null` csak kisbetűsen érvényes. Szöveges értékben pedig a belső dupla idézőjeleket megfelelően kezelni kell. Ezek a hibák különösen másolás-beillesztés után fordulnak elő gyakran.

Egy hibás példa

Az alábbi részletben az utolsó vessző miatt a JSON nem érvényes:

```json { "nev": "Kiss Anna", "aktiv": true, } ```

A javított változatból a záró vessző hiányzik:

```json { "nev": "Kiss Anna", "aktiv": true } ```

Így ellenőrizze gyorsan az adatot

Másolja be a JSON-szöveget az eszköz beviteli mezőjébe, majd indítsa el az ellenőrzést vagy formázást. Ha az adat érvényes, a rendezett nézetben könnyebb lesz átolvasni a kulcsokat, értékeket és listákat. Ha hiba van benne, először a jelzett sor környékét nézze meg, de ne csak az adott karaktert: gyakran egy korábbi hiányzó idézőjel vagy kapcsos zárójel okozza a későbbi hibajelzést.

Érdemes mindig a legkülső szerkezetet is ellenőrizni. Egy JSON-objektum kapcsos zárójellel, egy lista szögletes zárójellel kezdődik és végződik. Ha sok adatot kezel, haladjon blokkonként: előbb zárja le helyesen a belső objektumokat, utána ellenőrizze a teljes fájlt.

Formázás előtt és után: mire figyeljen?

A formázó általában nem javítja ki helyettünk a hibás adatot, mert nem tudhatja biztosan, mit akart jelenteni az eredeti tartalom. A feladata az, hogy a már érvényes JSON-t jól olvashatóvá tegye. Ezért hiba esetén előbb a validálás eredményét érdemes követni, és csak a javítás után formázni a teljes szöveget.

Az is fontos, hogy a kulcsnevek és értékek jelentése nem változhat meg. A `"ar": 12990` számérték, míg a `"ar": "12990"` szöveg. Ránézésre hasonlónak tűnnek, egy adatimport vagy automatizmus számára mégis teljesen más típusú adatot jelentenek.

Adatbiztonság nagyobb figyelmet érdemel

JSON-ellenőrzéshez lehetőleg csak olyan adatot másoljon be, amelyet biztonságosan kezelhet. Jelszót, banki adatot, személyazonosító okmányadatot, teljes ügyféllistát vagy más bizalmas információt ne adjon meg nyilvános online eszközben. Hibakereséshez sok esetben elég egy anonimizált minta: a neveket, e-mail-címeket és azonosítókat helyettesítse tesztértékekkel.

Ha egy import vagy integráció nem működik, a rendezett, validált JSON már önmagában közelebb visz a megoldáshoz. Előbb ellenőrizze a szerkezetet, utána az egyes mezők nevét és adattípusát - így a hiba keresése nem találgatás, hanem néhány célzott lépés lesz.