Formatowanie i walidacja JSON

Darmowe narzędzie do formatowania i walidacji JSON: upiększa, minifikuje i sprawdza JSON w przeglądarce, wskazując wiersz i kolumnę błędu.

Dane wejściowe

Wcięcie Sortuj klucze

Wynik

Jak korzystać z formatera JSON

Wklej JSON w pole wejściowe.
Wybierz Wcięcie: 2 spacje, 4 spacje lub tabulator. Włącz Sortuj klucze, jeśli chcesz mieć klucze obiektów w kolejności alfabetycznej.
Kliknij Formatuj (upiększ), aby ładnie sformatować JSON, albo Minifikuj, aby zapisać go w jednym zwartym wierszu.
Jeśli JSON jest niepoprawny, przeczytaj komunikat błędu z numerem wiersza i kolumny, popraw problem i spróbuj ponownie.
Skopiuj wynik i użyj go w kodzie, dokumentacji lub kliencie API.

Co robi to narzędzie

JSON (JavaScript Object Notation) to najpopularniejszy format wymiany danych między usługami internetowymi i częsty format plików konfiguracyjnych. Surowy JSON z API to często jeden gęsty wiersz, który trudno przeczytać. To narzędzie czyni go czytelnym, sprawdza jego poprawność i potrafi z powrotem go skompresować, gdy potrzebujesz zwartej wersji.

Formatuj (upiększ): dodaje znaki nowego wiersza i spójne wcięcia, dzięki czemu łatwo śledzić zagnieżdżenie obiektów i tablic. Możesz wcinać 2 lub 4 spacjami albo tabulatorem, zgodnie ze stylem projektu.
Minifikuj: usuwa wszystkie zbędne białe znaki, tworząc najmniejszy poprawny JSON – przydatny w żądaniach, do osadzania w kodzie lub zmniejszenia pliku.
Waliduj: sprawdza, czy dane wejściowe to poprawnie zbudowany JSON. Jeśli nie, narzędzie pokazuje błąd składni z wierszem i kolumną, aby można go było szybko znaleźć.
Sortuj klucze: porządkuje alfabetycznie klucze każdego obiektu. Ułatwia to przeglądanie dużych obiektów i znacznie upraszcza porównywanie dwóch dokumentów JSON obok siebie.

Najczęstsze błędy w JSON

Gdy walidacja się nie powiedzie, przyczyną jest zwykle jedna z poniższych rzeczy:

Przecinki na końcu: {"a": 1,} nie jest poprawnym JSON, choć wiele języków programowania na to pozwala.
Apostrofy: ciągi i klucze w JSON muszą używać cudzysłowów podwójnych. {'imie': 'Anna'} jest niepoprawne.
Klucze bez cudzysłowów: {imie: "Anna"} to poprawny JavaScript, ale niepoprawny JSON.
Komentarze: standardowy JSON nie dopuszcza komentarzy // ani /* */.
Brakujące przecinki lub nawiasy: zapomniany przecinek między dwoma elementami albo niezamknięty } lub ].
Wartości specjalne: undefined, NaN i Infinity nie należą do JSON.

Wiersz i kolumna w komunikacie błędu wskazują miejsce, w którym parser zauważył problem. Sam opis błędu pochodzi z parsera przeglądarki i zwykle jest po angielsku. Faktyczna pomyłka bywa tuż przed tym miejscem, np. brakujący przecinek na końcu poprzedniego wiersza.

Bezpieczne dla poufnych danych

Całe formatowanie, minifikacja i walidacja odbywają się lokalnie w twojej przeglądarce. Twój JSON nigdy nie jest wysyłany na serwer. To ważne, bo JSON często zawiera poufne informacje: odpowiedzi API z danymi klientów, tokeny dostępu, wewnętrzne pliki konfiguracyjne czy logi. Dzięki temu narzędziu te dane zostają na twoim urządzeniu.

Najczęściej zadawane pytania

Czy mój JSON jest wysyłany na serwer?

Nie. Narzędzie działa w całości w twojej przeglądarce, więc dane nigdy nie opuszczają twojego urządzenia. Możesz go używać z odpowiedziami API, plikami konfiguracyjnymi i innymi poufnymi danymi.

Czym różni się formatowanie od minifikacji?

Formatowanie dodaje znaki nowego wiersza i wcięcia, aby JSON był łatwy do czytania przez ludzi. Minifikacja usuwa wszystkie zbędne białe znaki, aby był jak najbardziej zwarty dla maszyn. Oba warianty zawierają te same dane.

Wcinać 2 spacjami, 4 spacjami czy tabulatorem?

To wyłącznie kwestia stylu – dane są w każdym przypadku identyczne. Dwie spacje są popularne w projektach JavaScript i dokumentacji API, cztery w projektach Pythona, a tabulatory pozwalają każdemu czytelnikowi wybrać własną szerokość wyświetlania. Wybierz to, co pasuje do twojego projektu.

Czy sortowanie kluczy zmienia moje dane?

Nie. W JSON kolejność kluczy w obiekcie nie ma znaczenia, więc ich sortowanie nie zmienia danych. Kolejność elementów w tablicach nigdy nie jest zmieniana.

Dlaczego błąd wskazuje zły wiersz?

Parser podaje miejsce, w którym zorientował się, że JSON jest niepoprawny. Jeśli zapomniałeś przecinka lub zamykającego cudzysłowu, często jest to początek następnego wiersza lub wartości. Sprawdź też fragment tuż przed wskazaną pozycją.

Czy narzędzie potrafi automatycznie naprawić niepoprawny JSON?

Nie. Narzędzie waliduje JSON i dokładnie wskazuje błąd składni, ale nie zgaduje poprawek. Popraw zgłoszony błąd i sformatuj ponownie.