JSON dla początkujących — składnia i użycie formatera

Co uznaje się za poprawny JSON?

JSON to format danych, a nie dowolny obiekt zapisany w JavaScript. Tekst i klucze obiektu wymagają podwójnych cudzysłowów. Standardowe JSON nie dopuszcza komentarzy, końcowych przecinków ani undefined. Na najwyższym poziomie może być także pojedyncza liczba, tekst, true, false lub null. RFC 8259.

{"project":"Weboteka","enabled":true,"tags":["tools"]}

Ten sam obiekt po formatowaniu:

{
  "project": "Weboteka",
  "enabled": true,
  "tags": ["tools"]
}

Jak używać formatera?

Wklej dane testowe do JSON Formatter, wybierz wcięcia i sprawdź wynik. Formater parsuje dane, więc błędne wejście wymaga poprawki. Nie obiecuje automatycznego naprawienia brakujących pól; pozycja błędu zależy także od parsera.

Poprawna składnia nie oznacza poprawności wobec API. Pole price może być liczbą poprawną składniowo, lecz niedopuszczalną według reguł danego systemu. Sprawdź osobno schemat i znaczenie wartości.

Minifikacja i inne formaty

Minifikacja usuwa zbędne białe znaki. Jej efekt zależy od wejścia i późniejszej kompresji transportowej. Nie można ogólnie twierdzić, że JSON jest o 20–30% mniejszy od XML lub zawsze szybciej przetwarzany — trzeba porównać ten sam model danych i implementację.

Nie każdy plik z JSON w nazwie ma identyczną gramatykę. Konfiguracja tsconfig.json korzysta z parsera TypeScript, który dopuszcza rozszerzenia takie jak komentarze; nie wklejaj ich bez sprawdzenia do API oczekującego standardowego JSON. TypeScript: tsconfig.

O czym pamiętać przy danych?

MongoDB przechowuje BSON z dodatkowymi typami, a nie po prostu zwykły JSON. MongoDB: typy BSON.

Bardzo duże liczby mogą stracić precyzję po parsowaniu w JavaScript. Nie zastępuj undefined przez null bez ustalenia kontraktu: brak pola i jawny null mogą znaczyć coś innego. Nie umieszczaj sekretów w publicznym pliku konfiguracyjnym. Do formatowania przykładów wybieraj dane, które można bezpiecznie pokazać.