Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

JSON — parsowanie i serializacja danych

JSON to wbudowany obiekt JavaScript służący do odczytu i zapisu tekstu JSON. JSON.parse tworzy wartości z tekstu, a JSON.stringify serializuje wartości, lecz nie zachowuje wszystkich typów ani struktury obiektów JavaScript.

Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Składnia

JSON.parse(text[, reviver])
JSON.stringify(value[, replacer[, space]])

JSON jest wbudowanym obiektem ECMAScript, a nie konstruktorem ani funkcją: nie używaj new JSON() ani JSON(). Format JSON opisuje obiekty, tablice, ciągi znaków, liczby, wartości logiczne i null. Wymaga podwójnych cudzysłowów dla nazw właściwości i ciągów; nie dopuszcza komentarzy ani końcowych przecinków.

JSON.parse(text, reviver) odczytuje tekst; niepoprawna składnia powoduje SyntaxError. Opcjonalny reviver przekształca wartości od elementów zagnieżdżonych ku korzeniowi; zwrócenie undefined usuwa właściwość. Poprawne parsowanie nie sprawdza oczekiwanego schematu danych, a duże liczby całkowite mogą utracić precyzję jako Number.

JSON.stringify(value, replacer, space) zwraca tekst albo undefined. replacer może być funkcją przekształcającą wartości lub tablicą nazw wybierającą właściwości obiektów; space steruje wcięciami. W przypadku obiektów innych niż tablice domyślnie serializowane są własne, wyliczalne właściwości o kluczach tekstowych. W przypadku tablic odczytywane są wartości pod indeksami od 0 do length - 1, także z właściwości odziedziczonych lub niewyliczalnych. Dodatkowe właściwości o nazwach niebędących indeksami są pomijane, nawet jeśli są wyliczalne. Metoda toJSON, jeśli istnieje, może zmienić reprezentację.

Właściwości o wartościach undefined, funkcjach lub symbolach są pomijane w obiektach, lecz takie elementy tablic stają się null. NaN i nieskończoności również stają się null. Cykle oraz nieprzekształcone wartości BigInt powodują TypeError. Dlatego zapis i ponowny odczyt nie są uniwersalnym sposobem głębokiego kopiowania.

Wpis i przykład dotyczą podstawowych metod, a nie pełnego zestawu nowszych rozszerzeń. Bieżący projekt specyfikacji opisuje też JSON.rawJSON i JSON.isRawJSON; przed ich użyciem sprawdź dostępność w środowisku docelowym. Wynik w Node 24 nie dowodzi obsługi w przeglądarce.

Przykłady

const text = '{"name":"Ada","scores":[3,5]}';
const data = JSON.parse(text);
data.scores.push(8);
console.log(JSON.stringify(data));
console.log(JSON.stringify({ missing: undefined, items: [undefined] }));

Wynik

{"name":"Ada","scores":[3,5,8]}
{"items":[null]}

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła