Formatter JSON

Formater JSON

Wklej JSON z odpowiedzi API, pliku konfiguracyjnego, webhooka albo fragmentu logu, a potem wybierz Formatowanie, Minifikację lub Walidację. Formatter rozwija zagnieżdżone obiekty i tablice z wcięciem 2 albo 4 spacji, minifikator usuwa zbędne odstępy, a walidator sprawdza, czy tekst jest poprawnym JSON-em przed skopiowaniem wyniku.

Jak formatować JSON

  1. 1

    Wklej swój JSON

    Dodaj pełną wartość JSON: obiekt, tablicę, ciąg znaków, liczbę, wartość logiczną albo `null`.

  2. 2

    Wybierz akcję

    Użyj Formatowania dla czytelnego wyniku, Minifikacji dla zwartego wyniku albo Walidacji do sprawdzenia składni.

  3. 3

    Wybierz wcięcie

    Dla sformatowanego wyniku wybierz 2 spacje w projektach webowych albo 4 spacje, jeśli taki styl obowiązuje w repozytorium.

  4. 4

    Skopiuj wynik

    Sprawdź komunikat parsera albo sformatowany wynik, a następnie skopiuj go do edytora, klienta API lub dokumentacji.

Co robi ten formatter JSON

  • Formatuje JSON: zamienia zwartą treść, taką jak {"a":1,"b":[1,2,3]}, na czytelny JSON z wcięciami.
  • Minifikuje JSON: usuwa odstępy potrzebne tylko do czytania, przydatne w krótkich przykładach, osadzeniach i payloadach przesyłanych w żądaniach.
  • Waliduje składnię: sprawdza, czy wklejony tekst da się sparsować jako JSON. To kontrola składni, nie walidacja JSON Schema.
  • Obsługuje każdą wartość główną JSON: obiekty i tablice są najczęstsze, ale tekst JSON może być też ciągiem znaków, liczbą, true, false albo null.
  • Upraszcza pracę: wklej, wybierz akcję, sprawdź wynik i skopiuj rezultat.

Czego celowo nie zmienia

  • Nie naprawia automatycznie błędnego JSON-a. Komunikat parsera podpowiada, co trzeba poprawić.
  • Nie akceptuje otoczek JSONP, takich jak callback({...}).
  • Nie akceptuje komentarzy ani końcowych przecinków z JSONC, jeśli najpierw ich nie usuniesz.
  • Nie sortuje kluczy obiektów. Istniejąca kolejność zostaje zachowana na tyle, na ile pozwalają parser i serializer.
  • Nie waliduje reguł biznesowych, pól wymaganych ani schematów API. Do tego użyj walidatora JSON Schema.

Wybór formatowania

Sytuacja Najlepsza akcja Dlaczego pomaga
Czytanie odpowiedzi API Formatowanie z 2 spacjami Zagnieżdżone obiekty i tablice łatwiej przejrzeć.
Dopasowanie do stylu repozytorium Formatowanie z 2 albo 4 spacjami Spójne wcięcia ułatwiają code review.
Osadzenie payloadu w żądaniu Minifikacja Usuwa odstępy bez zmiany wartości JSON.
Sprawdzanie danych skopiowanych z logów Walidacja Potwierdza przed użyciem, że wklejony fragment jest kompletnym JSON-em.
Przygotowanie dokumentacji API Formatowanie Przykłady łatwiej sprawdzić i skopiować.

Problemy składni JSON, które wykrywa

Komunikat parsera Częsta przyczyna Co zrobić
Unexpected token ' at position X Pojedyncze cudzysłowy wokół klucza lub ciągu znaków Użyj podwójnych cudzysłowów dla stringów JSON.
Unexpected end of JSON input Brak zamykającej klamry, nawiasu lub cudzysłowu Sprawdź koniec wklejonego tekstu.
Unexpected token , at position X Przecinek po ostatnim elemencie Usuń końcowy przecinek.
Unexpected token a at position X Klucz bez cudzysłowów, NaN albo undefined Ujmij klucze w cudzysłowy i używaj tylko poprawnych wartości JSON.
Unexpected token / at position X Komentarz skopiowany z JSONC albo JavaScript Usuń komentarze // i /* */ przed walidacją.

Praktyczne wskazówki

  • Najpierw formatuj odpowiedź do przeglądu, a minifikuj dopiero wtedy, gdy naprawdę potrzebujesz zwartego payloadu.
  • Waliduj JSON przed wklejeniem go do dokumentacji, zgłoszeń lub klientów API, zwłaszcza jeśli źródłem był częściowy wpis logu.
  • Zachowaj wcięcia używane w projekcie. Zmiana 2 spacji na 4 w istniejącym pliku może wygenerować trudny do przeglądu diff.
  • Nie wklejaj sekretów, danych dostępowych produkcji ani danych klientów do ogólnego narzędzia webowego. Do wrażliwych payloadów używaj zatwierdzonego narzędzia wewnętrznego lub offline.

Najczęściej zadawane pytania

Nie. To narzędzie sprawdza tylko składnię JSON. Jeśli musisz potwierdzić pola wymagane, dozwolone wartości albo kształt obiektów, użyj walidatora JSON Schema po poprawnym sparsowaniu danych.

Ścisły JSON nie pozwala na komentarze ani końcowe przecinki. Usuń komentarze w stylu JSONC i ostatnie przecinki przed walidacją albo formatowaniem.

Użyj stylu, który już obowiązuje w projekcie. Dwie spacje są częste w JavaScript i konfiguracjach webowych; cztery spacje bywają czytelniejsze w niektórych repozytoriach backendowych.

Unikaj wklejania sekretów, tokenów dostępu, danych logowania i rekordów klientów do ogólnego formattera webowego. Do wrażliwych payloadów używaj zatwierdzonego narzędzia wewnętrznego albo offline.

Powiązane narzędzia