Formater i walidator JSON online

Wklej poniżej swój plik JSON, aby natychmiast go sformatować, uporządkować lub zminimalizować. Narzędzie sprawdza poprawność pliku JSON podczas formatowania i wyświetla dokładny komunikat o błędzie, jeśli coś jest nie tak. Wszystko odbywa się lokalnie w przeglądarce — Twoje dane nigdy nie są przesyłane na żaden serwer.

Jak używać

Wklej swój plik JSON do pola wprowadzania po lewej stronie (lub kliknij „Załaduj przykład”, aby to wypróbować).
Wybierz wcięcie 2-spacowe lub 4-spacowe.
Kliknij „Formatuj”, aby poprawić wygląd, lub „Zminimalizuj”, aby skompresować tekst do jednego wiersza.
Jeśli plik JSON jest nieprawidłowy, zapoznaj się z komunikatem o błędzie wyświetlonym poniżej pól, aby zidentyfikować problem.
Kliknij „Kopiuj”, aby skopiować wynik do schowka.

Przykład

Wejście

{"name":"CodeKitHub","tools":["json","base64"],"free":true}

Wynik

{
  "name": "CodeKitHub",
  "tools": [
    "json",
    "base64"
  ],
  "free": true
}

Te same dane, sformatowane z wcięciem o szerokości dwóch spacji. Minify działa odwrotnie: usuwa wszystkie spacje.

Czym jest to narzędzie?

Formater JSON przetwarza surowy, zminifikowany lub nieuporządkowany tekst JSON, nadając mu spójne wcięcia i podziały wierszy, dzięki czemu staje się on łatwiejszy do odczytania. JSON (JavaScript Object Notation) to najpopularniejszy format danych stosowany w interfejsach API, plikach konfiguracyjnych i systemach logowania, jednak serwery zazwyczaj wysyłają go w postaci jednego długiego, nieczytelnego wiersza, aby oszczędzać przepustowość.

Narzędzie to pełni również funkcję walidatora JSON: analizuje wprowadzone dane zgodnie z tymi samymi rygorystycznymi zasadami, co przeglądarki, więc jeśli w pliku JSON brakuje przecinka, klucz nie jest ujęty w cudzysłowy lub na końcu znajduje się zbędny przecinek, wyświetli się dokładny komunikat o błędzie zamiast cichego niepowodzenia.

Praktyczne wskazówki

Debugujesz API? Najpierw wklej surową odpowiedź, a dopiero potem ją sformatuj — narzędzie do walidacji wskazuje dokładny wiersz i kolumnę każdego błędu składniowego, co jest o wiele lepszym rozwiązaniem niż mrużenie oczu nad jednoliniowym fragmentem kodu.
W przypadku czytania na ekranie należy stosować wcięcie o szerokości 2 spacji oraz zminimalizować rozmiar pliku przed wklejeniem JSON-a do adresu URL, zmiennej środowiskowej lub wiadomości na czacie — w takich przypadkach spacje zajmują tylko bajty.
Komentarze w stylu JSON5 oraz przecinki na końcu wyrażenia to dwie najczęstsze przyczyny, dla których ręcznie wpisana konfiguracja „wygląda poprawnie”, ale nie przechodzi walidacji: ścisły format JSON nie dopuszcza żadnej z tych rzeczy.
W przypadku bardzo dużych plików (logów, zrzutów baz danych) formatuj tylko ten fragment, który Cię interesuje — dzięki temu edytor będzie działał płynnie, a strukturę pliku łatwiej będzie śledzić.

Jak to się wpisuje w rzeczywiste procesy robocze

Najczęstszy scenariusz, z jakim mamy do czynienia: interfejs API zwraca dane JSON zakodowane w Base64 lub zminimalizowane w treści tokenu lub webhooka. Najpierw należy zdekodować Base64, następnie sformatować JSON, a na końcu porównać dwie odpowiedzi, jeśli coś uległo zmianie między środowiskami. Każdy z tych kroków ma tutaj dedykowane narzędzie, a dane nigdy nie opuszczają przeglądarki na żadnym z etapów.

Programiści frontendu stosują minifikację równie często, co formatowanie: wysyłasz duży statyczny plik JSON? Jego minifikacja pozwala zazwyczaj zaoszczędzić 20–30% miejsca, zanim jeszcze rozpocznie się kompresja gzip.

→ Koder / dekoder Base64 · Porównanie tekstów

Typowe zastosowania

Odczytanie zminimalizowanej odpowiedzi API zwróconej w postaci jednego nieczytelnego wiersza w celu zrozumienia jej struktury podczas debugowania.
Sprawdzanie poprawności pliku konfiguracyjnego (takiego jak `package.json` lub plik ustawień oparty na formacie JSON), który z nieznanych przyczyn nie jest poprawnie odczytywany przez aplikację.
Udostępnianie czytelnego, sformatowanego fragmentu kodu JSON w zgłoszeniu błędu, podczas przeglądu kodu lub w dokumentacji.
Zmniejszenie rozmiaru danych JSON do minimalnej postaci przed umieszczeniem ich w parametrze adresu URL lub zapisaniem w kolumnie bazy danych o ograniczonej pojemności.

Dlaczego warto go używać?

Szybkie debugowanie odpowiedzi API — jednym kliknięciem przekształć jednowierszową odpowiedź w czytelny format.

Natychmiastowe wykrywanie błędów składniowych wraz z dokładnym opisem przyczyny niepowodzenia parsowania pliku JSON.

Zminimalizuj plik JSON przed osadzeniem go w kodzie lub wysłaniem przez sieć.

W 100% prywatne: przetwarzanie odbywa się w Twojej przeglądarce, żadne dane nie są przesyłane ani przechowywane.

Bez logowania, bez ograniczeń, działa na urządzeniach mobilnych.

Najczęściej zadawane pytania

Czy moje dane JSON są przesyłane na serwer?

Nie. To narzędzie działa wyłącznie w przeglądarce przy użyciu JavaScript. Dane w formacie JSON nigdy nie opuszczają Twojego urządzenia, dzięki czemu można z niego bezpiecznie korzystać w przypadku danych wrażliwych lub wewnętrznych.

Dlaczego mój plik JSON jest nieprawidłowy?

Najczęstsze przyczyny to: brakujące lub zbędne przecinki, klucze bez cudzysłowów, pojedyncze cudzysłowy zamiast podwójnych, przecinki na końcu listy po ostatnim elemencie oraz komentarze (JSON nie dopuszcza komentarzy). Komunikat o błędzie wyświetlany pod polem wprowadzania danych informuje, co wykrył parser.

Jaka jest różnica między opcjami „Formatuj” a „Minifikuj”?

Funkcja „Formatuj” dodaje wcięcia i znaki końca linii, aby plik JSON był czytelny dla człowieka. Funkcja „Minifikuj” usuwa wszystkie zbędne spacje, aby plik JSON był jak najmniejszy — przydaje się to przed jego przesłaniem lub osadzeniem.

Czy obowiązuje ograniczenie rozmiaru?

Narzędzie nie nakłada żadnego sztywnego ograniczenia. Przetwarzanie bardzo dużych plików (rzędu dziesiątek megabajtów) może przebiegać wolno w zależności od posiadanego urządzenia, ponieważ całe przetwarzanie odbywa się lokalnie w przeglądarce.

Czy to rozwiązanie może automatycznie naprawić uszkodzony plik JSON?

Nie — narzędzie wskazuje dokładnie, gdzie w pliku JSON występuje błąd, dzięki czemu można go naprawić, ale nie zgaduje ani nie zmienia danych użytkownika. Jest to zamierzone działanie: ciche „naprawianie” danych może ukrywać prawdziwe błędy.