JSON pretty print przekształca kompaktowy, trudny do odczytania JSON w starannie wcięty, wieloliniowy format. O ile maszyny przetwarzają jednoliniowy JSON bez problemu, ludzie potrzebują struktury — hierarchii wizualnej, wyrównanych nawiasów i spójnych wcięć — by szybko rozumieć złożone dane.
Surowy JSON z API, baz danych i plików logów jest często minifikowany, by oszczędzać przepustowość. Pretty print przywraca czytelną strukturę potrzebną do debugowania, przeglądania i rozumienia danych bez wysiłku.
🔍
Szybsze debugowanie
Znajdź brakujące pola, błędne wartości i błędy struktury w sekundy, zamiast analizować ścianę tekstu znak po znaku.
👥
Czystsze przeglądy kodu
Przeglądanie zmian w plikach konfiguracyjnych JSON w pull requestach jest o wiele łatwiejsze z właściwymi wcięciami — recenzenci mogą skupić się na tym, co się zmieniło.
🔌
Inspekcja API
Eksplorując nowe API, sformatowane odpowiedzi pozwalają zrozumieć model danych i strukturę zagnieżdżenia na pierwszy rzut oka.
📝
Dokumentacja i udostępnianie
Sformatowany JSON jest gotowy do wklejenia w dokumenty, wiki, zgłoszenia i Slack bez konieczności ręcznej analizy przez kogokolwiek.
Wybór wcięcia
Zarówno 2, jak i 4 spacje są szeroko stosowane. Właściwy wybór zazwyczaj zależy od przewodnika stylu zespołu lub osobistych preferencji.
2 spacje
Najpopularniejszy wybór w społecznościach JavaScript i JSON. Pliki pozostają kompaktowe, a jednocześnie czytelne. Używany przez npm, ESLint i większość przewodników stylu JS.
4 spacje
Powszechny w projektach Python, Java i C#. Zapewnia więcej przestrzeni wizualnej i jest często preferowany przy głęboko zagnieżdżonych strukturach.
Typowe przypadki użycia
Debugowanie odpowiedzi API
Wklej surową odpowiedź API i natychmiast zobaczysz pełną strukturę danych, zagnieżdżone obiekty i zawartość tablic w czytelnym układzie.
Odczytywanie plików konfiguracyjnych
Konfiguracja przechowywana w zminifikowanym JSON staje się banalna do odczytu i edycji po sformatowaniu — koniec z szukaniem konkretnego klucza.
Analiza logów
Logi strukturyzowane często zawierają payloady JSON. Formatowanie pojedynczych wpisów znacznie przyspiesza analizę przyczyn problemów.
Dokumentacja dla deweloperów
Przejrzyste, wcięte przykłady JSON w dokumentacji API pozwalają deweloperom natychmiast zrozumieć strukturę żądań i odpowiedzi.
Eksploracja danych
Pracując z nieznanym zbiorem danych, pretty print ujawnia pełny schemat — pola, typy i zagnieżdżenie — bez konieczności czytania dokumentacji.
Testowanie i QA
Porównywanie oczekiwanego i rzeczywistego JSON w niepomyślnych testach jest o wiele łatwiejsze z spójnym wcięciem i strukturą linia po linii.
Pretty Print w terminalu
Nie zawsze potrzebne jest narzędzie przeglądarkowe. Te polecenia formatują JSON bezpośrednio w terminalu bez dodatkowych instalacji.
JSON pretty printing (also called JSON formatting or JSON beautifying) converts compact, minified JSON into a human-readable layout with consistent indentation and line breaks. It makes nested structures, arrays, and key-value pairs easy to scan and debug.
Czy pretty print zmienia dane?
Nie. Dodawane są wyłącznie białe znaki — żadne dane, klucze, wartości ani kolejność nie są modyfikowane. Sformatowany plik JSON jest semantycznie identyczny z oryginałem.
Co jest lepsze: 2 czy 4 spacje?
Żadne nie jest obiektywnie lepsze. 2 spacje są bardziej kompaktowe i są domyślne w wielu narzędziach JavaScript. 4 spacje zapewniają więcej separacji wizualnej. Używaj tego, co wskazuje przewodnik stylu twojego zespołu.
Czy mogę sformatować nieprawidłowy JSON?
Nie — dane wejściowe muszą być prawidłowym JSON. Jeśli plik zawiera końcowe przecinki, apostrofy lub komentarze (JSONC/JSON5), najpierw przekonwertuj go do standardowego JSON.
Jak sformatować JSON w DevTools przeglądarki?
W Chrome/Firefox DevTools kliknij przycisk {} na dole panelu odpowiedzi sieciowej, by automatycznie sformatować. Możesz też uruchomić JSON.stringify(obj, null, 2) w konsoli, by sformatować dowolny obiekt JavaScript.