Jak formatować i walidować JSON online

JSON (JavaScript Object Notation) to najczęściej używany format wymiany danych na świecie. Stworzony przez Douglasa Crockforda na początku lat 2000, stał się de facto standardem dla API webowych, plików konfiguracyjnych, baz danych NoSQL i strukturalnego przechowywania danych.

Jego popularność wynika z prostoty: czytelny dla ludzi, łatwy do parsowania przez maszyny, lekki rozmiarem i natywnie wspierany przez JavaScript (język webu). Dziś praktycznie każda nowoczesna aplikacja webowa używa JSON do komunikacji między frontendem a backendem.

Ale ta prostota kryje pułapkę: jeden źle umieszczony przecinek, brakujący cudzysłów lub niezamknięty nawias unieważnia cały plik. Dlatego dobry formater/walidator JSON jest niezbędnym narzędziem dla każdego programisty.

Końcowy przecinek (trailing comma). Błąd numer 1. W JavaScript {"a": 1, "b": 2,} jest poprawne. W ścisłym JSON ten końcowy przecinek jest zabroniony.

Pojedyncze cudzysłowy. JSON akceptuje tylko podwójne cudzysłowy. {'name': 'John'} jest niepoprawne — musi być {"name": "John"}.

Komentarze. JSON nie wspiera komentarzy. Bez // ani /* */. Jeśli potrzebujesz komentarzy, użyj JSON5 lub JSONC.

Klucze bez cudzysłowów. {name: "John"} to JavaScript, nie JSON. Klucze muszą być w podwójnych cudzysłowach.

Znaki sterujące. Literalne znaki nowej linii w ciągach są zabronione. Użyj \n zamiast tego.

NaN, Infinity, undefined. Te wartości JavaScript nie są poprawnymi wartościami JSON. Użyj null zamiast tego.

Krok 1: Wklej swój JSON. Skopiuj i wklej surowy JSON do edytora. Kod jest automatycznie analizowany w czasie rzeczywistym.

Krok 2: Wykrywanie błędów. Błędy składni są podświetlane z komunikatem wyjaśniającym. Narzędzie wskazuje dokładną linię i pozycję każdego błędu.

Krok 3: Automatyczne formatowanie. Kliknij "Formatuj", aby starannie wciąć JSON. Wybierz między 2 lub 4 spacjami wcięcia.

Krok 4: Skopiuj lub pobierz. Pobierz sformatowany JSON jednym kliknięciem. Wszystko dzieje się w przeglądarce.

Nazywaj klucze w camelCase. firstName zamiast first_name lub FirstName. To najpowszechniejsza konwencja w API.

Używaj spójnych typów. Jeśli pole jest liczbą, nie umieszczaj go w cudzysłowach. "age": 25 a nie "age": "25".

Unikaj nadmiernego zagnieżdżenia. Więcej niż 4-5 poziomów głębokości sprawia, że JSON jest trudny do czytania i utrzymania.

Używaj tablic dla list. Nawet jeśli lista zawiera tylko jeden element, preferuj tablicę dla spójności.

Dokumentuj swoją strukturę. Użyj JSON Schema do definiowania i walidacji oczekiwanej struktury danych.

REST API. JSON jest domyślnym formatem prawie wszystkich nowoczesnych API. Odpowiedzi API to JSON, ciała żądań POST/PUT również.

Konfiguracja. package.json (Node.js), tsconfig.json (TypeScript), .eslintrc.json — nowoczesne pliki konfiguracyjne masowo używają JSON.

Bazy danych. MongoDB przechowuje dokumenty BSON (binarny JSON). PostgreSQL ma natywny typ JSONB. Firebase Realtime Database to zasadniczo gigantyczne drzewo JSON.

Konwersja. CSV ↔ JSON to jedna z najczęstszych konwersji. Allplix oferuje dedykowane narzędzia do tych konwersji w obu kierunkach.