O tomto nástroji
Formátovanie JSON (často nazývané pekná tlač alebo skrášľovanie) využíva kompaktný JSON a pridáva biele znaky – zalomenie riadkov, odsadenie, konzistentné rozstupy – aby bola štruktúra viditeľná pre ľudí. Kompaktný formát JSON je tým správnym formátom na prenos: minimalizuje počet bajtov cez kábel a úložisko. Formátovaný JSON je tým správnym formátom na kontrolu: odsadená hierarchia odhaľuje vnorenú štruktúru na prvý pohľad, robí rozdiely zmysluplnými a umožňuje vývojárom lokalizovať konkrétne polia bez mentálnej analýzy dokumentu.
Tento formátovač analyzuje vstup ako JSON, aby potvrdil, že je platný, a potom ho znova vyšle s konzistentným odsadením. Neplatný vstup spôsobuje chybu poukazujúcu na problém so syntaxou. Platný vstup sa preformátuje bez ohľadu na to, aký kompaktný alebo chaotický bol zdroj. Predvolené odsadenie na dve medzery zodpovedá najbežnejšej konvencii JavaScriptu.
Formátovač tiež ponúka minifikáciu (inverznú operáciu), ktorá odstráni všetky nepotrebné medzery, aby sa vytvoril najmenší platný JSON. Minimalizovaný výkon je užitočný na prenos výroby; formátovaný výstup je užitočný pri vývoji a ladení.
Prečo formátovať JSON
Čítanie hlboko vnoreného JSON bez odsadenia je v podstate nemožné – štruktúra je technicky prítomná, ale neviditeľná. Dokonca aj stredne zložitý formát JSON má obrovské výhody z formátovania. Kontrolóri kódu, ladiči API a každý, kto sa snaží porozumieť dátovému zaťaženiu, potrebuje formátovaný JSON, aby videli, čo tam vlastne je.
Chyby zachytáva aj formátovanie. Ak JSON zlyhá pri analýze počas formátovania, chybové hlásenie identifikuje presnú polohu problému so syntaxou – často chýba čiarka, kľúč v úvodzovkách alebo zatúlaná čiarka na konci, ktorú produkčný systém neoznačil. Formátovač je najjednoduchší dostupný validátor JSON.
Ako používať
Prilepte JSON, kliknite na formát.
- Prilepte svoj JSON: Prilepte nespracovaný alebo kompaktný JSON do vstupnej oblasti. Funguje aj presúvanie súborov .json myšou.
- Vyberte odsadenie: Predvolená hodnota je 2 medzery. Použite 4 medzery pre projekty, ktoré sa riadia touto konvenciou, alebo karty, ak to vaše následné nástroje vyžadujú.
- Formátovať: Vstup sa analyzuje cez JSON.parse na potvrdenie platnosti, potom sa serializuje pomocou JSON.stringify a vybratého odsadenia. Chyby vo vstupe vytvárajú chybové hlásenie analýzy identifikujúce miesto problému.
- Skopírujte alebo stiahnite: Skopírujte naformátovaný JSON do schránky alebo uložte ako .json. Výstup je štrukturálne identický so vstupom, ale s konzistentnými medzerami.
Technické detaily
Formátovač používa JSON.parse a JSON.stringify, rovnaký pár pri každom spustení JavaScriptu. Analýza sa riadi RFC 8259 (aktuálna špecifikácia JSON), akceptuje striktné JSON, ale odmieta literály objektov JavaScript, komentáre, čiarky na konci a ďalšie rozšírenia JSON5.
JSON.stringify akceptuje argument odsadenia: číslo (medzery) alebo reťazec (vlastný znak odsadenia, napríklad tabulátor). Formátovač ponúka obe možnosti. Výstup je zoradený podľa zdrojového poradia pre objekty (od ES2015 zachovalo poradie vkladania vlastností vo všetkých hlavných motoroch).
Okrajové prípady: veľké čísla nad Number.MAX_SAFE_INTEGER strácajú presnosť pri analýze (známe obmedzenie JSON; pre identifikátory, ktoré presahujú 2^53, použite reťazcové hodnoty). Unicode úniky v reťazcoch sú zachované doslova. Z každého riadku sa odstránia koncové medzery.
Často kladené otázky
- Aké typy chýb JSON tento nástroj zisťuje?
- Nástroj zisťuje chýbajúce čiarky, nezhodné zátvorky/zátvorky, neplatné escapovanie reťazca, koncové čiarky, reťazce v jednoduchých úvodzovkách a ďalšie porušenia syntaxe podľa špecifikácie RFC 8259 JSON.
- Dokáže spracovať veľmi veľké súbory JSON?
- áno. Formátovač spracováva JSON vo vašom prehliadači pomocou natívnej analýzy JavaScriptu, takže efektívne spracováva súbory až do niekoľkých megabajtov. V prípade extrémne veľkých súborov (50 MB+) závisí čas spracovania od vášho zariadenia.
- Podporuje JSON s komentármi (JSONC)?
- Štandardný JSON neumožňuje komentáre. Ak váš vstup obsahuje komentáre, validátor ich označí ako chyby. Pre podporu JSONC odstráňte komentáre pred formátovaním.
- Zmení formátovanie hodnoty mojich údajov?
- Nie. Formátovaním sa upravia iba biele miesta a odsadenie – vaše typy údajov, hodnoty a štruktúra zostanú úplne rovnaké.
- Sú podporované funkcie JSON5 (komentáre, čiarky na konci)?
- Nie. Formátovač prísne dodržiava RFC 8259. Funkcie JSON5 spôsobujú chyby analýzy. Ak chcete pracovať s JSON5, najprv konvertujte na štandardný JSON pomocou analyzátora JSON5.
- Je môj JSON nahraný na server?
- Nie. Analýza a formátovanie prebieha výlučne vo vašom prehliadači pomocou vstavaných funkcií JSON.
- Stratia veľké čísla presnosť?
- JavaScript predstavuje čísla ako 64-bitové plávajúce čísla, takže celé čísla nad 2^53 (približne 9 kvadriliónov) strácajú presnosť. Pre ID alebo iné veľké celočíselné hodnoty ich uložte ako reťazce v JSON.
- Môžem zoradiť klávesy podľa abecedy?
- JSON.stringify netriedi kľúče. Použite samostatný krok triedenia (alebo formátovač s podporou triedenia) na zoradenie kľúčov podľa abecedy pred zjednocovaním.
Related Articles
DeveloperEssential Developer Tools: JSON, Base64, RegEx, and More
A comprehensive overview of the developer utilities every programmer should know, from data format converters to encoding tools.
9 min readDeveloper & SecurityHashing, Encryption, and Encoding Explained: A Developer's Security Guide
Understand the differences between hashing, encryption, and encoding. Learn when to use MD5, SHA-256, Base64, AES, and other cryptographic tools in your applications.
10 min readData & ProductivitySpreadsheet & Data Conversion Guide: Excel, CSV, JSON, and More
Learn how to convert between spreadsheet and data formats like Excel, CSV, JSON, and XML. Practical tips for handling data migration, cleaning, and transformation.
10 min readPrivacy & TechnologyWhy Browser-Based Tools Are the Future: No Installs, No Uploads, No Risk
Discover why browser-based tools are replacing desktop software and cloud uploads. Learn how client-side processing keeps your files private while delivering powerful functionality.
7 min read