5 typowych błędów składniowych JSON i jak je naprawić

# 5 typowych błędów składniowych JSON i jak je naprawić

JSON (JavaScript Object Notation) jest wszechobecny, ale mimo swojej prostoty, programiści wciąż napotykają na irytujące błędy składniowe. Ten przewodnik pomoże Ci je szybko zidentyfikować i naprawić.

Dlaczego błędy w JSON są tak częste?

Składnia JSON jest bardzo rygorystyczna. W przeciwieństwie do JavaScript, JSON:

• ✅ Wymaga podwójnych cudzysłowów dla tekstów.
• ✅ Zabrania przecinków na końcu (trailing commas).
• ✅ Nie pozwala na żadne komentarze.

---

Błąd #1: Przecinki na końcu listy (Trailing Commas)

To najczęstszy błąd. Dodanie przecinka po ostatnim elemencie obiektu lub tablicy jest dozwolone w JS, ale zabronione w JSON.

❌ Źle

{
  "imie": "Alicja",
  "aktywna": true,
}

✅ Dobrze

{
  "imie": "Alicja",
  "aktywna": true
}

---

Błąd #2: Pojedyncze cudzysłowy

Użycie pojedynczych cudzysłowów (') jest częstym błędem przy ręcznym pisaniu JSON lub kopiowaniu obiektów z JavaScript.

❌ Źle

{ 'status': 'ok' }

---

Błąd #3: Nieujęte w cudzysłów klucze

W JSON każdy klucz musi być ciągiem znaków ujętym w podwójne cudzysłowy.

❌ Źle

{ name: "Alicja" }

---

Błąd #4: Nieprawidłowe znaki ucieczki (Escaping)

Zapominanie o ominięciu znaków specjalnych, takich jak ukośniki w ścieżkach Windows, często psuje walidację.

❌ Źle

{ "sciezka": "C:\Users\Dokumenty" }

✅ Dobrze

{ "sciezka": "C:\\\\Users\\\\Dokumenty" }

---

Błąd #5: Komentarze w JSON

JSON to format danych, a nie język programowania, dlatego nie obsługuje żadnych komentarzy (// ani / /).

Rozwiązanie:

Jeśli musisz dodać opis, stwórz dodatkowe pole, np. "_komentarz": "Twoja uwaga".

Podsumowanie

Pamiętaj o dwóch złotych zasadach: tylko podwójne cudzysłowy i zero przecinków na końcu sekcji. Jeśli masz wątpliwości, użyj BigJSON Validator, który natychmiast wskaże Ci problematyczną linię.