Jak formatować i walidować JSON online

Jeśli pracujesz z API, plikami konfiguracyjnymi lub jakimkolwiek typem ustrukturyzowanych danych, regularnie spotykasz się z JSON. A jeśli kiedykolwiek wpatrywałeś się w ścianę zminifikowanego JSON szukając brakującego nawiasu, wiesz, dlaczego formatowanie ma znaczenie.

Co robi formater JSON

Surowy JSON z odpowiedzi API lub zminifikowanego pliku wygląda tak:

{"users":[{"name":"Alice","age":30,"roles":["admin","editor"]},{"name":"Bob","age":25,"roles":["viewer"]}]}

Formater przekształca to w coś czytelnego:

{
  "users": [
    {
      "name": "Alice",
      "age": 30,
      "roles": ["admin", "editor"]
    },
    {
      "name": "Bob",
      "age": 25,
      "roles": ["viewer"]
    }
  ]
}

Te same dane, ale w końcu możesz je przeczytać, wykryć błędy i zrozumieć strukturę.

Jak formatować JSON online

1. Wklej swój JSON w polu wejściowym. Formater natychmiast wykrywa błędy składni i waliduje strukturę.
2. Wybierz wcięcie — wybierz 2 lub 4 spacje albo kliknij Minifikuj, aby skompresować JSON do jednej linii.
3. Skopiuj wynik — sformatowane wyjście zawiera kolorowanie składni. Skopiuj je do swojego kodu, pliku konfiguracyjnego lub dokumentacji.

Częste błędy JSON i jak je wykrywać

Większość błędów JSON sprowadza się do kilku częstych pułapek:

• Brakujące lub nadmiarowe przecinki — przecinek po ostatnim elemencie tablicy lub obiektu jest nieprawidłowy w JSON (w przeciwieństwie do JavaScript)
• Klucze bez cudzysłowów — JSON wymaga podwójnych cudzysłowów wokół wszystkich kluczy: "name", a nie name
• Pojedyncze cudzysłowy — JSON akceptuje tylko podwójne cudzysłowy: "value", a nie 'value'
• Wiszące przecinki — {"a": 1,} jest nieprawidłowy; usuń przecinek po ostatnim wpisie

Dobry formater podświetla dokładnie, gdzie znajduje się błąd, abyś mógł go naprawić bez zgadywania.

Kiedy formatować, kiedy minifikować

Formatuj (uczyń czytelnym), gdy musisz:

• Czytać i rozumieć dane
• Debugować odpowiedzi API
• Edytować pliki konfiguracyjne
• Udostępniać JSON kolegom

Minifikuj, gdy musisz:

• Wysyłać dane przez sieć (lżejszy ładunek = szybszy transfer)
• Przechowywać JSON w bazie danych lub logu, gdzie czytelność nie ma znaczenia
• Osadzać JSON w parametrze URL lub polu formularza

Wskazówki dotyczące pracy z JSON

• Waliduj przed wysłaniem — jeśli ręcznie konstruujesz żądanie API, najpierw wklej swój JSON do walidatora. Jeden źle umieszczony przecinek może powodować mylące błędy po stronie serwera.
• Używaj wcięcia 2 spacji dla głęboko zagnieżdżonych danych. Utrzymuje to krótsze linie i strukturę łatwiejszą do przeglądania.
• Dodaj narzędzie do ulubionych — jeśli regularnie pracujesz z JSON, posiadanie formatera jednym kliknięciem oszczędza czas w porównaniu z wyszukiwaniem go za każdym razem.