Jak korzystać z narzędzia
- 1.Wklej JSON do pola, upuść na nie plik
.jsonalbo kliknij „Wybierz plik”. - 2.Sformatowany wynik pojawia się w trakcie pisania. Jako wcięcie wybierz 2 spacje, 4 spacje lub tabulatory albo wybierz „Minifikuj”, aby usunąć wszystkie białe znaki.
- 3.Jeśli JSON jest nieprawidłowy, zobaczysz, co jest nie tak, wraz z dokładnym numerem wiersza i kolumny. Kliknij „Pokaż w polu wejściowym”, aby od razu przejść do problemu.
- 4.Włącz „Sortuj klucze A–Z”, aby uporządkować alfabetycznie właściwości każdego obiektu. Przydaje się to przed porównaniem dwóch plików.
- 5.Skopiuj wynik lub pobierz go jako plik
.json.
Czym jest JSON?
JSON (JavaScript Object Notation) to tekstowy format danych strukturalnych. Jest standardem w internetowych API i plikach konfiguracyjnych, a odczytać i zapisać go potrafi niemal każdy język programowania.
Dokument JSON zawiera jedną wartość: obiekt z parami nazwa–wartość w nawiasach klamrowych, tablicę w nawiasach kwadratowych, ciąg znaków w podwójnym cudzysłowie, liczbę, true, false lub null. Obiekty i tablice można zagnieżdżać dowolnie głęboko.
Najczęstsze błędy w JSON i jak je naprawić
Większość błędów w JSON wynika z nawyków, na które pozwalają JavaScript, Python czy YAML, ale nie JSON: przecinka po ostatnim elemencie, pojedynczych cudzysłowów zamiast podwójnych, nazw właściwości bez cudzysłowu, komentarzy oraz wartości takich jak undefined, NaN czy pythonowe True i None.
Inne częste przyczyny to brakujący przecinek między dwoma elementami, podwójny cudzysłów lub ukośnik wsteczny w ciągu znaków zapisany bez sekwencji ucieczki oraz cudzysłowy typograficzne wklejone z edytora tekstu. Walidator dokładnie nazywa problem i zaznacza, gdzie on jest, tak samo w każdej przeglądarce, nawet tam, gdzie jej własny komunikat o błędzie jest niejasny.
{
"name": "nestoo",
}{
"name": "nestoo"
}Formatowanie bez zmieniania danych
Wiele formaterów wczytuje JSON do JavaScriptu i wypisuje go ponownie, co po cichu go zmienia: liczby całkowite większe niż 9 007 199 254 740 991, np. 64-bitowe identyfikatory, tracą ostatnie cyfry, 1.0 zmienia się w 1, a sekwencje ucieczki zostają zastąpione znakami, które oznaczają.
Ten formater zmienia wcięcia bezpośrednio w tekście, więc każda liczba i każdy ciąg znaków pozostają dokładnie takie, jak je zapisano, a sortowanie zachowuje zduplikowane klucze, które JavaScript po cichu by odrzucił. Pliki o rozmiarze kilku megabajtów formatują się w ułamku sekundy, a przy bardzo dużym wyniku kolorowanie składni się wyłącza, aby strona działała płynnie.
Pytania i odpowiedzi
Jak sprawdzić, czy mój JSON jest prawidłowy?
Wklej go do pola powyżej. Przy prawidłowym JSON zobaczysz komunikat „Prawidłowy JSON” z liczbą wierszy i rozmiarem, a przy nieprawidłowym opis problemu z dokładnym numerem wiersza i kolumny. Sprawdzanie jest zgodne ze standardem JSON (RFC 8259): obowiązują te same reguły co w JSON.parse w Twojej przeglądarce.
Dlaczego przecinek na końcu jest w JSON błędem?
Standard JSON nie pozwala na przecinek po ostatnim elemencie obiektu ani tablicy, choć JavaScript i wiele innych języków na to pozwala. Usuń przecinek przed nawiasem zamykającym, a JSON stanie się prawidłowy.
Czy JSON może zawierać komentarze?
Nie. Standardowy JSON nie ma komentarzy, więc // i /* */ sprawiają, że staje się nieprawidłowy. Formaty takie jak JSONC i JSON5 je dopuszczają, ale większość parserów nie. Aby zostawić notatkę w zwykłym JSON, zapisz ją w zwykłej właściwości, np. "_comment".
Na czym polega minifikacja JSON?
Minifikacja usuwa wszystkie spacje, tabulatory i podziały wierszy poza ciągami znaków. Dane pozostają identyczne, ale plik się zmniejsza (w przypadku JSON z wcięciami często o jedną trzecią lub więcej), dzięki czemu odpowiedzi API są szybsze, a dane zajmują mniej miejsca.
Czy mój JSON jest wysyłany na serwer?
Nie. Formatowanie i walidacja odbywają się w całości w Twojej przeglądarce, a nic, co wkleisz, nie jest przesyłane ani zapisywane. Po załadowaniu strony narzędzie działa nawet offline.