Formatownik JSON

Przegląd Formatu JSON

JSON (JavaScript Object Notation) to lekki format wymiany danych. Zrozumienie jego zasad jest kluczowe dla skutecznego tworzenia i manipulowania strukturami danych JSON.

Główne Zasady

1. Obiekty
   • Zamknięte w nawiasach klamrowych { }.
   • Pusty obiekt: { }
2. Tablice (Arrays)
   • Zamknięte w nawiasach kwadratowych [ ].
   • Pusta tablica: [ ]
3. Elementy (Pary Klucz-Wartość)
   • Klucze muszą być unikalne w obrębie obiektu i ujęte w podwójne cudzysłowy ("klucz").
     • (Niektóre parsery akceptują pojedyncze cudzysłowy, ale należy ich unikać ze względów kompatybilności.)
   • Wartości zależą od typu:
     • Ciąg znaków (String): Ujęty w podwójne cudzysłowy.
     • Wartość logiczna (Boolean): Użyj true lub false.
     • Liczba (Number): Stosuj się do zasad liczb zmiennoprzecinkowych podwójnej precyzji; dozwolona jest notacja naukowa. Unikaj zer wiodących.
     • Null: Reprezentowany przez null.
     • Inne typy (np. daty): Dla kompatybilności konwertuj na ciągi znaków.
   • Znaki specjalne w ciągach znaków muszą być poprzedzone znakiem ukośnika odwrotnego (\).
4. Zasady Składni
   • Oddzielaj elementy obiektów lub wartości tablic przecinkami, z wyjątkiem ostatniego.
   • Rozszerzenie pliku: .json
   • Typ MIME: application/json

Przykład JSON

{
  "anObject": {
    "numericProperty": -122,
    "stringProperty": "An offensive \" is problematic",
    "nullProperty": null,
    "booleanProperty": true,
    "dateProperty": "2011-09-23"
  },
  "arrayOfObjects": [
    { "item": 1 },
    { "item": 2 },
    { "item": 3 }
  ],
  "arrayOfIntegers": [1, 2, 3, 4, 5]
}

JSON w JavaScript

Ponieważ JSON pochodzi z JavaScriptu, integruje się z nim bezproblemowo. Jednak bezpieczne i poprawne przetwarzanie jest kluczowe, aby uniknąć błędów i zagrożeń bezpieczeństwa.

Parsowanie Ciągów JSON

Unikaj używania eval()

eval() może parsować JSON, ale stanowi zagrożenie bezpieczeństwa, ponieważ umożliwia wykonywanie dowolnego kodu JavaScript. Nigdy nie używaj go w środowisku produkcyjnym.

Przykład (Niebezpieczne – Nie używać):

var jsonString = '{"property":"value"}';
var jsonObject = eval('(' + jsonString + ')');
alert(jsonObject.property);

Użyj zamiast tego JSON.parse()

JSON.parse() bezpiecznie konwertuje ciąg JSON na obiekt JavaScript.

Przykład (Bezpieczne):

var jsonString = '{"property":"value"}';
var jsonObject = JSON.parse(jsonString);
alert(jsonObject.property);

Tworzenie Ciągów JSON

Użyj JSON.stringify(), aby przekształcić obiekt JavaScript w ciąg JSON.

Przykład:

var jsObject = { property: "value" };
var jsonString = JSON.stringify(jsObject);
alert(jsonString); // Output: '{"property":"value"}'

Tworzenie Obiektów JavaScript Bezpośrednio

Obiekty JavaScript można tworzyć bezpośrednio za pomocą składni JSON w kodzie.

Przykład:

var jsonObject = { property: "value" };
alert(jsonObject.property); // Output: 'value'

Najlepsze Praktyki i Rekomendacje

1. Zawsze używaj podwójnych cudzysłowów dla kluczy i wartości typu string dla maksymalnej kompatybilności.
2. Unikaj używania eval() do parsowania JSON, aby zapobiec lukom w zabezpieczeniach.
3. Stosuj ukośniki odwrotne do znaków specjalnych w ciągach znaków.
4. Używaj JSON.stringify() i JSON.parse() do bezpiecznego i wydajnego przetwarzania JSON.
5. Waliduj dane JSON przed ich parsowaniem, szczególnie jeśli pochodzą z niezaufanych źródeł.