JSON formázó

A JSON szintaxis és a strukturált adatok kezelése

A JSON (JavaScript Object Notation) a modern webes adatcsere legelterjedtebb formátuma. Az API-válaszok, konfigurációs fájlok és adatbázis-mentések strukturált tárolására szolgáló formátum szigorú szintaktikai szabályokra épül. Bár a gépek számára a felesleges szóközök és soremelések nélküli, egyetlen sorba tömörített adathalmaz az optimális, az emberi szem számára az ilyen szöveg olvashatatlan.

A JSON formázó segít átláthatóvá tenni a bonyolult adatstruktúrákat. A formázás során a rendszer strukturált behúzásokkal és soremelésekkel látja el a kódot, így a hierarchikus kapcsolatok azonnal felismerhetővé válnak. A formázás mellett a tömörítés (minify) funkció eltávolítja a felesleges szóközöket és soremeléseket, miközben a JSON-adatok tartalma teljesen változatlan marad. Ez a művelet csökkenti a fájlméretet, ami elengedhetetlen az adatok hatékony tárolásához vagy hálózati továbbításához.

Bemeneti lehetőségek és fájlkezelési szabályok

Az eszköz többféle módon képes fogadni a feldolgozandó adatokat:

• Beillesztett szöveg: A JSON-adatok közvetlenül bemásolhatók az input területre.
• Fájl megnyitása: A felhasználók .json vagy .txt kiterjesztésű fájlokat nyithatnak meg a "Fájl megnyitása" gombra kattintva, vagy a fájl egyszerű behúzásával (drag and drop).

A fájlok betöltése során a következő technikai korlátok és szabályok érvényesülnek:

• Kódolás: Kizárólag UTF-8 kódolású szöveges fájlok támogatottak. Ha a fájl kódolása ettől eltér, a rendszer a következő hibaüzenetet jeleníti meg: "Ez a fájl nem UTF-8 szöveg, ezért itt nem nyitható meg."
• Fájlméret-korlát: A maximális bemeneti méret 10 MiB. Ha a fájl meghaladja ezt, a "A fájl túl nagy — a korlát {limit}." üzenet jelenik meg. Ha a beillesztett szöveg lépi át a feldolgozási határt, a rendszer az "A bemenet nagyobb, mint {limit} — ez több, mint amennyit ez az eszköz fel tud dolgozni." hibaüzenetet adja vissza.
• Fájltípus ellenőrzése: Nem megfelelő kiterjesztés esetén a "Nem támogatott fájltípus — válasszon.json vagy.txt fájlt." figyelmeztetés látható.
• Olvasási hibák: Ha a fájl sérült vagy nem hozzáférhető, a "Nem sikerült beolvasni a fájlt. Próbálja meg újra kiválasztani." hibaüzenet jelenik meg.

A sikeres betöltést a rendszer a "{name} betöltve ({size})." üzenettel nyugtázza.

Feldolgozási korlátok és teljesítmény

A JSON formázó nagy méretű dokumentumok kezelésére is alkalmas, azonban a böngésző stabilitásának megőrzése érdekében bizonyos korlátokat alkalmaz:

1. Szinkron feldolgozási küszöb: A 250 000 karaktert meg nem haladó dokumentumok ellenőrzése és formázása azonnal lefut.
2. Időtúllépés: Ha a JSON elemzése és ellenőrzése túl sokáig tart, a folyamat biztonsági okokból leáll, és a "A JSON ellenőrzése túl sokáig tartott, ezért leállt. Próbálkozzon kisebb dokumentummal." üzenet jelenik meg.
3. Nagy egészek megőrzése: A feldolgozás során a rendszer a rendkívül nagy egész számokat (large integers) pontosan, értékvesztés vagy kerekítés nélkül őrzi meg.
4. Ismétlődő kulcsok kezelése: A JSON specifikációval összhangban az objektumokon belüli ismétlődő kulcsok hibát eredményeznek ahelyett, hogy a rendszer csendben összevonná vagy felülírná őket. Ilyenkor az "Ismétlődő kulcs: {key} — formázás előtt távolítsa el az egyiket" hibaüzenet jelenik meg.

Navigáció a fanézettel és adatkinyerés

A hagyományos "Kód" nézet mellett az eszköz egy interaktív "Fa" nézetet is biztosít, amely lehetővé teszi a JSON-struktúra vizuális feltérképezését.

gyökér
 ├── felhasználó: "Minta János"
 ├── azonosító: 10293
 └── jogosultságok (tömb)

A fanézet használatára és korlátaira az alábbi szabályok vonatkoznak:

• Érvényesség: Hibás szintaxisú adatok esetén a fanézet nem renderelhető, ilyenkor a "Javítsa ki a JSON-t a fanézet megjelenítéséhez." felirat látható.
• Méretbeli korlátozások: Ha a dokumentum túl nagy, a "Ez a JSON túl nagy a fanézet kirajzolásához." vagy a "Ez a JSON túl sok értéket tartalmaz a fanézethez." figyelmeztetés jelenik meg.
• Kibontási korlát: Az összes csomópont kibontásakor a rendszer maximalizálja a megjelenített sorok számát: "Ez a JSON túl nagy a teljes kibontáshoz — az első {count} sor látható." A felhasználó a "További {count} megjelenítése…" gombbal tölthet be újabb elemeket.

A fanézetben lehetőség van kulcsok és értékek keresésére a "Keresés a kulcsok és értékek között" mező segítségével. A találatok számát a rendszer a "{current} / {total}" vagy a limitált "{current} / {total}+" formátumban jelzi ki, találat hiányában pedig a "Nincs találat" jelzést adja.

Adatkinyerés JSON Pointer és JSONPath segítségével

A fanézet egyes csomópontjainál a "Másolási lehetőségek: {key}" menüből az alábbi adatok másolhatók ki:

• Érték másolása: Az adott kulcshoz tartozó közvetlen érték vágólapra helyezése.
• JSON Pointer másolása: Az RFC 6901 szabvány szerinti elérési út (például /felhasznalo/jogosultsagok/0).
• JSONPath másolása: A lekérdező nyelv szerinti szintaxis (például $.felhasznalo.jogosultsagok).

Hibakeresés és nem szabványos formátumok javítása

Ha a beillesztett JSON érvénytelen, az eszköz pontosan meghatározza a hiba helyét a "{line}. sor, {col}. oszlop" formátumban, és felkínálja az "Ugrás a hibához" lehetőséget.

Gyakori szintaktikai hibák

A rendszer az alábbi specifikus hibákat képes azonosítani:

• "Hiányzó vessző az elemek között"
• "Fölösleges vessző a záró zárójel előtt"
• "Az objektumkulcsokat dupla idézőjelek közé kell tenni"
• "Hiányzó kettőspont egy tulajdonságnév után"
• "Egy szövegnél hiányzik a záró idézőjel"
• "A JSON túl korán ér véget — csonkának tűnik"
• "Váratlan karakter ott, ahol értéknek kellene állnia"
• "Ez a JSON túl mélyen egymásba ágyazott a feldolgozáshoz"

Automatikus javítási funkciók

Az eszköz képes felismerni a nem szabványos vagy sérült JSON-szerkezeteket, és javítási javaslatokat kínál fel a "Javítás előnézete" gomb segítségével:

Ha a javítás nem hajtható végre, a "Ezt a bemenetet nem sikerült automatikusan kijavítani." üzenet jelenik meg. Sikeres javítás után a "Javítás alkalmazva. A visszavonáshoz nyomja meg a Ctrl/Cmd+Z billentyűket." visszajelzés látható.

Kulcsok rendezése és exportálás

A strukturált adatok összehasonlítását nagyban megkönnyíti az objektumkulcsok rendezése. A "Kulcsok rendezése" funkció az objektumkulcsokat rekurzívan, kódpont szerinti sorrendbe rendezi, miközben a tömbök belső elemeinek sorrendje soha nem változik. A művelet elvégzése után a "Kulcsok rendezve — a tömbök sorrendje változatlan. A visszavonáshoz nyomja meg a Ctrl/Cmd+Z billentyűket." üzenet jelenik meg.

A feldolgozott adatok a "Letöltés" gombbal menthetők el, amelynek sikeres lefutását a "{name} letöltve." üzenet igazolja.

Adatvédelem és helyi feldolgozás

A JSON formázó használata során az Ön adatai maximális biztonságban vannak. A JSON feldolgozása a böngészőjében történik. Semmilyen adat nem töltődik fel a BroBroGo szervereire. Minden validálási, formázási, tömörítési és javítási műveletet a helyi böngészőmotor hajt végre, így az adatok nem hagyják el az Ön eszközét.

Gyakran Ismételt Kérdések

Feltöltődik a JSON-om a szerverre?

Nem. A formázó helyben, a böngészőjében fut, és nem tölti fel a JSON-adatokat.

Mit csinál a tömörítés (minify) funkció?

A tömörítés (minify) eltávolítja a felesleges szóközöket és soremeléseket, miközben a JSON-adatok tartalma teljesen változatlan marad.

Miért kapok hibát az ismétlődő kulcsokra?

A szabványos JSON-ban az objektumok kulcsainak egyedinek kell lenniük. Az eszköz a hibák elkerülése érdekében jelzi az ismétlődéseket, hogy Ön még a formázás előtt javíthassa azokat.

Mi az a JSONC és hogyan kezelhető?

A JSONC a JSON egy olyan változata, amely engedélyezi a megjegyzések (például // megjegyzés) és a záró vesszők használatát. Az eszközben átválthat JSONC szintaxisra, vagy az automatikus javítással szabványos, megjegyzések nélküli JSON-ná alakíthatja azt.