Formatowanie JSON

Czym jest JSON?

JSON (JavaScript Object Notation) to lekki format wymiany danych, który jest łatwy do odczytania i zapisu przez ludzi, a także łatwy do parsowania i generowania przez maszyny. Mimo swojej nazwy, JSON jest niezależny od języka i jest używany przez praktycznie każdy nowoczesny język programowania, API i system baz danych.

JSON obsługuje sześć typów danych: ciągi znaków (w podwójnych cudzysłowach), liczby, wartości logiczne (true/false), null, obiekty (pary klucz-wartość w nawiasach klamrowych) i tablice (uporządkowane listy w nawiasach kwadratowych). Jego prostota i wszechstronność sprawiły, że stał się dominującym formatem dla interfejsów API, plików konfiguracyjnych i przechowywania danych.

Jak formatować JSON

Wklej swój JSON do obszaru wejściowego. Formater weryfikuje składnię, wykrywa błędy i generuje poprawnie wcięte wyjście. Jeśli Twój JSON jest nieprawidłowy, dokładna lokalizacja błędu jest podświetlona, abyś mógł go szybko naprawić. Możesz przełączać się między wyjściem upiększonym (czytelnym) a zminifikowanym (zwartym).

Co robi formater JSON?

• Weryfikuje składnię JSON i raportuje dokładną lokalizację błędów.
• Upiększa wyjście ze spójnym wcięciem i podziałami wierszy.
• Minifikuje JSON przez usunięcie zbędnych białych znaków dla mniejszego rozmiaru pliku.

Częste błędy JSON

• Końcowe przecinki po ostatnim elemencie w obiekcie lub tablicy — JSON nie zezwala na końcowe przecinki, w przeciwieństwie do JavaScript.
• Pojedyncze cudzysłowy zamiast podwójnych — JSON wymaga podwójnych cudzysłowów wokół wszystkich kluczy i wartości tekstowych.
• Niecytowane nazwy właściwości — każdy klucz musi być ciągiem znaków w podwójnych cudzysłowach.
• Brakujące przecinki między parami klucz-wartość lub elementami tablicy.
• Komentarze w JSON — specyfikacja JSON nie obsługuje żadnego rodzaju komentarzy.

Efektywna praca z JSON

Podczas debugowania odpowiedzi API najpierw sformatuj JSON, aby struktura była widoczna. Głęboko zagnieżdżone obiekty są znacznie łatwiejsze do nawigowania z odpowiednim wcięciem. W przypadku plików konfiguracyjnych rozważ użycie JSON5 lub JSONC (JSON z komentarzami), jeśli Twoje narzędzia to obsługują.

Dla dużych plików JSON (powyżej 1 MB) używaj parserów strumieniowych zamiast ładowania całego dokumentu do pamięci. Narzędzia takie jak jq (wiersz poleceń) lub online JSON path finders mogą wyodrębniać konkretne wartości ze złożonych struktur bez przeformatowywania całego dokumentu.

JSON a inne formaty

W porównaniu do XML, JSON jest bardziej zwięzły i łatwiejszy do parsowania. W porównaniu do YAML, JSON jest bardziej rygorystyczny i mniej podatny na błędy wcięcia. W porównaniu do CSV, JSON obsługuje dane zagnieżdżone i hierarchiczne w naturalny sposób. Każdy format ma swoje mocne strony, ale równowaga prostoty i ekspresywności JSON sprawia, że jest domyślnym wyborem dla interfejsów API.

Czy mój JSON jest bezpieczny?

Tak. Całe przetwarzanie odbywa się w przeglądarce przy użyciu wbudowanej funkcji JSON.parse() JavaScript. Twoje dane nigdy nie są wysyłane na serwer. Możesz bezpiecznie formatować poufne pliki konfiguracyjne, klucze API i prywatne dane.

Często zadawane pytania

Jaki jest maksymalny rozmiar pliku JSON?

Specyfikacja JSON nie definiuje limitu rozmiaru. Praktyczne limity zależą od parsera i dostępnej pamięci. Większość interfejsów API obsługuje ładunki JSON do 10–100 MB bez problemów. To narzędzie działające w przeglądarce działa dobrze z plikami do kilku megabajtów.

Czy JSON może zawierać funkcje lub daty?

Nie. JSON obsługuje tylko ciągi znaków, liczby, wartości logiczne, null, obiekty i tablice. Funkcje nie są prawidłowymi wartościami JSON. Daty muszą być reprezentowane jako ciągi znaków (zazwyczaj w formacie ISO 8601 jak „2024-01-15T10:30:00Z