Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

JSON — parsiranje i serijalizacija podataka

JSON je ugrađeni objekt JavaScripta za čitanje i zapisivanje JSON teksta. JSON.parse stvara vrijednosti iz teksta, a JSON.stringify serijalizira vrijednosti, ali ne čuva sve tipove ni strukture objekata JavaScripta.

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

Sintaksa

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

JSON je ugrađeni objekt ECMAScripta, a ne konstruktor ni funkcija: nemojte upotrebljavati new JSON() ni JSON(). JSON format opisuje objekte, polja, nizove znakova, brojeve, logičke vrijednosti i null. Nazivi svojstava i nizovi znakova moraju biti u dvostrukim navodnicima; komentari i završni zarezi nisu dopušteni.

JSON.parse(text, reviver) čita tekst; nevaljana sintaksa uzrokuje SyntaxError. Neobavezni reviver mijenja vrijednosti od ugniježđenih elemenata prema korijenu; vraćanje vrijednosti undefined briše svojstvo. Uspješno parsiranje ne provjerava očekivanu shemu podataka, a veliki cijeli brojevi mogu izgubiti preciznost kao vrijednosti Number.

JSON.stringify(value, replacer, space) vraća tekst ili undefined. replacer može biti funkcija koja mijenja vrijednosti ili polje naziva koje odabire svojstva objekata; space određuje uvlačenje. Kod objekata koji nisu polja prema zadanim se postavkama serijaliziraju vlastita, nabrojiva svojstva s ključevima u obliku nizova znakova. Kod polja se čitaju vrijednosti na indeksima od 0 do length - 1, čak i ako su odgovarajuća svojstva naslijeđena ili nenabrojiva. Dodatna svojstva čiji nazivi nisu indeksi zanemaruju se, čak i ako su nabrojiva. Postojeća metoda toJSON može promijeniti prikaz.

Svojstva čija je vrijednost undefined, funkcija ili simbol izostavljaju se iz objekata, ali odgovarajući elementi polja postaju null. I NaN i beskonačnosti postaju null. Ciklusi i nekonvertirane vrijednosti BigInt uzrokuju TypeError. Stoga ponovno serijaliziranje i parsiranje nije univerzalna metoda dubokog kopiranja.

Ovaj zapis i primjer obrađuju osnovne metode, a ne cijeli skup novijih proširenja. Aktualni nacrt specifikacije opisuje i JSON.rawJSON i JSON.isRawJSON; prije upotrebe provjerite jesu li dostupni u ciljnom okruženju. Rezultat u Node 24 ne dokazuje podršku u preglednicima.

Primjeri

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] }));

Rezultat

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

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori