JSON Formátovač

Spracovanie a validácia dát v prehliadači

JSON Formátovač je špecializovaný nástroj určený na formátovanie, validáciu a minifikáciu dát vo formáte JSON. Celý proces spracovania prebieha lokálne. Váš JSON sa spracováva priamo vo vašom prehliadači. Na servery BroBroGo sa nič neodosiela [privacy]. Vďaka tomu môžete pracovať s dátami bez obáv z prenosu citlivých informácií cez sieť.

Nástroj podporuje prácu s textovým vstupom aj nahrávanie súborov. Používateľ môže vložiť text priamo do vstupného poľa alebo otvoriť súbory s príponou .json a .txt. Súbory je možné nahrať kliknutím na tlačidlo pre otvorenie súboru alebo ich jednoduchým pretiahnutím do pracovnej oblasti.

Možnosti vstupu a technické obmedzenia

Pri práci s dátami v nástroji platia presne definované technické pravidlá a limity, ktoré zaisťujú stabilitu behu aplikácie priamo v prehliadači:

• Podporované formáty a kódovanie: Nástroj dokáže otvoriť výhradne súbory s príponou .json alebo .txt. Súbory musia byť uložené v kódovaní UTF-8. Ak sa pokúsite nahrať iný formát, zobrazí sa upozornenie: „Nepodporovaný typ súboru — vyberte súbor.json alebo.txt.“. Ak súbor nespĺňa podmienku kódovania, systém vypíše: „Tento súbor nie je text v kódovaní UTF-8, preto ho tu nemožno otvoriť.“ [Tento súbor nie je text v kódovaní UTF-8, preto ho tu nemožno otvoriť.].
• Veľkostné limity: Maximálna veľkosť súboru, ktorý je možné do aplikácie nahrať, je striktne obmedzená. Pri prekročení tohto limitu sa zobrazí chybové hlásenie: „Súbor je príliš veľký — limit je {limit}.“. Ak celkový vstup na spracovanie prekročí maximálnu kapacitu nástroja, ktorá je stanovená na 10 MiB, systém oznámi: „Vstup je väčší než {limit}, čo je viac, než dokáže tento nástroj spracovať.“ [Vstup je väčší než {limit}, čo je viac, než dokáže tento nástroj spracovať., 1].
• Časový limit spracovania: Ak je štruktúra dokumentu príliš komplexná a analýza trvá neúmerne dlho, proces sa z bezpečnostných dôvodov preruší s hláškou: „Kontrola tohto JSON trvala príliš dlho a bola zastavená. Skúste menší dokument.“. Synchrónna hranica spracovania je nastavená na 250 000 znakov.
• Presnosť číselných hodnôt: Nástroj zachováva veľké celé čísla (large integers) v ich pôvodnej podobe bez akejkoľvek straty presnosti, ku ktorej inak v prostredí JavaScriptu pri bežnom parsovaní často dochádza.

Formátovanie, minifikácia a triedenie kľúčov

Nástroj ponúka tri základné operácie na úpravu textovej podoby JSON dát:

1. Formátovanie (Pretty Print): Zarovná štruktúru, pridá zalomenia riadkov a odsadenie podľa zvolenej úrovne. Po úspešnom preformátovaní sa zobrazí stavová správa: „JSON bol naformátovaný.“ [formatted].
2. Minifikácia: Odstráni zo štruktúry všetky nepotrebné biele znaky, medzery a zalomenia riadkov, čím sa minimalizuje výsledná veľkosť dát pre prenos alebo ukladanie. Po dokončení nástroj indikuje stav: „JSON bol minifikovaný.“ [minified].
3. Zoradenie kľúčov: Funkcia rekurzívne zoradí kľúče objektov podľa poradia kódových bodov (code-point order). Poradie prvkov v poliach (arrays) zostáva vždy nezmenené. Po vykonaní tejto akcie sa zobrazí správa: „Kľúče zoradené — poradie polí zostalo nezmenené. Stlačením Ctrl/Cmd+Z akciu vrátite.“.

Používateľ má k dispozícii aj voľbu syntaxe, kde môže prepínať medzi štandardným formátom „JSON“ a formátom „JSONC“, ktorý umožňuje používanie komentárov.

Detekcia neštandardných formátov a automatické opravy

Nástroj disponuje pokročilým analyzátorom, ktorý dokáže identifikovať, ak vložený text nezodpovedá prísnej špecifikácii JSON, ale nesie znaky iných známych formátov. V takom prípade ponúkne špecifické riešenie:

Ak systém nájde opraviteľnú chybu, sprístupní sa tlačidlo „Zobraziť opravu“. V okne náhľadu sa zobrazí porovnanie s označením „Pôvodné“ a „Po oprave“. Používateľ môže zmeny potvrdiť kliknutím na „Použiť opravu“ alebo akciu zrušiť tlačidlom „Zrušiť“. Po úspešnej oprave sa zobrazí oznam: „Oprava bola použitá. Stlačením Ctrl/Cmd+Z ju vrátite.“. Ak automatická oprava nie je možná, systém vypíše: „Tento vstup sa nepodarilo automaticky opraviť.“.

Identifikácia syntaktických chýb

Pri neplatnom formáte nástroj neumožní zobraziť dáta v stromovej štruktúre a namiesto toho vypíše lokalizovanú chybu s presným určením miesta problému vo formáte „riadok {line}, stĺpec {col}“. Medzi najčastejšie detekované syntaktické chyby patria:

• „Medzi položkami chýba čiarka“
• „Nadbytočná čiarka pred uzatváracou zátvorkou“
• „Kľúče objektu musia byť v dvojitých úvodzovkách“
• „Za názvom vlastnosti chýba dvojbodka“
• „Reťazcu chýba uzatváracia úvodzovka“
• „JSON končí príliš skoro — vyzerá odrezaný“
• „Neočakávaný znak na mieste, kde má byť hodnota“
• „Tento JSON je vnorený príliš hlboko na to, aby ho bolo možné spracovať“
• „Duplicitný kľúč {key} — pred formátovaním jeden odstráňte“ (Nástroj duplicitné kľúče neslučuje ani nezahadzuje, ale vyžaduje ich manuálne odstránenie).

Navigácia v stromovej štruktúre a export

Pre prehľadné prezeranie zložitej hierarchie slúži stromové zobrazenie. Ak je JSON neplatný, v tejto záložke sa zobrazí výzva: „Ak chcete zobraziť stromovú štruktúru, opravte chyby v JSON.“. Pre veľké dokumenty platia v stromovom zobrazení obmedzenia:

• Ak je dokument príliš veľký, zobrazí sa: „Tento JSON je príliš veľký na vykreslenie v stromovom zobrazení.“.
• Ak dokument obsahuje nadmerné množstvo prvkov, systém vypíše: „Tento JSON obsahuje príliš veľa hodnôt na to, aby ho bolo možné vykresliť ako strom.“.
• Pri pokuse o rozbalenie všetkých uzlov veľkého stromu nástroj obmedzí výstup a zobrazí: „Tento JSON je príliš veľký na úplné rozbalenie — zobrazuje sa prvých {count} riadkov.“. Zvyšné uzly je možné postupne odkrývať tlačidlom „Zobraziť ďalších {count}…“.

V stromovom zobrazení je integrované vyhľadávanie kľúčov a hodnôt. Výsledky vyhľadávania sa zobrazujú v tvare „{current} z {total}“, prípadne pri dosiahnutí limitu vyhľadávania ako „{current} z {total}+“. Ak sa hľadaný výraz v strome nenachádza, zobrazí sa text „Žiadne zhody“.

Pri kliknutí na konkrétny uzol v strome je k dispozícii kontextové menu s možnosťami kopírovania. Používateľ môže skopírovať samotnú hodnotu („Kopírovať hodnotu“), cestu vo formáte JSON Pointer („Kopírovať JSON Pointer“) alebo cestu vo formáte JSONPath („Kopírovať JSONPath“).

Často kladené otázky (FAQ)

Odosiela sa môj JSON na server?

Nie. Formátovač beží lokálne vo vašom prehliadači a vaše dáta JSON nikam neodosiela. Všetky operácie validácie, formátovania aj vykresľovania stromu prebiehajú výhradne vo vašom zariadení.

Čo robí funkcia minifikácie?

Minifikácia odstráni nepotrebné medzery a zalomenia riadkov, pričom zachová rovnaké dáta JSON. Tento krok je užitočný na zmenšenie objemu dát pred ich uložením alebo odoslaním cez sieť.

Ako nástroj nakladá s duplicitnými kľúčmi v objektoch?

Na rozdiel od niektorých parserov, ktoré duplicitné kľúče ticho zlúčia alebo prepíšu, tento nástroj nahlási chybu. Pred formátovaním alebo zobrazením stromu musíte duplicitný kľúč manuálne odstrániť.

Prečo sa mi nezobrazuje stromové zobrazenie (Tree view)?

Stromové zobrazenie vyžaduje, aby bol vložený JSON úplne syntakticky správny. Ak obsahuje chyby, namiesto stromu sa zobrazí upozornenie, ktoré vás vyzve na opravu chýb v kóde. Zobrazenie stromu môže byť zablokované aj v prípade, že je dokument príliš veľký alebo obsahuje príliš veľa hodnôt [Tento JSON je príliš veľký na vykreslenie v stromovom zobrazení., Tento JSON obsahuje príliš veľa hodnôt na to, aby ho bolo možné vykresliť ako strom.].