Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

JSON — razčlenjevanje in serializacija podatkov

JSON je vgrajeni objekt JavaScripta za branje in zapisovanje besedila JSON. JSON.parse iz besedila ustvari vrednosti, JSON.stringify pa vrednosti serializira, vendar ne ohrani vseh vrst ali struktur objektov JavaScripta.

Različica: 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 vgrajeni objekt ECMAScript, ne konstruktor ali funkcija: ne uporabljajte new JSON() ali JSON(). Oblika JSON opisuje objekte, polja, nize, števila, logične vrednosti in null. Imena lastnosti in nizi morajo biti v dvojnih narekovajih; komentarji in zaključne vejice niso dovoljeni.

JSON.parse(text, reviver) prebere besedilo; neveljavna sintaksa povzroči SyntaxError. Izbirni reviver spreminja vrednosti od ugnezdenih elementov proti korenu; če vrne undefined, se lastnost izbriše. Uspešno razčlenjevanje ne preveri pričakovane podatkovne sheme, velika cela števila pa lahko kot vrednosti Number izgubijo natančnost.

JSON.stringify(value, replacer, space) vrne besedilo ali undefined. replacer je lahko funkcija, ki spreminja vrednosti, ali polje imen, ki izbere lastnosti objektov; space določa zamik. Pri objektih, ki niso polja, se privzeto serializirajo lastne, naštevne lastnosti z nizi kot ključi. Pri poljih se preberejo vrednosti na indeksih od 0 do length - 1, tudi če so ustrezne lastnosti podedovane ali nenaštevne. Dodatne lastnosti, katerih imena niso indeksi, se prezrejo, tudi če so naštevne. Morebitna metoda toJSON lahko spremeni predstavitev.

Lastnosti z vrednostjo undefined, funkcijo ali simbolom so v objektih izpuščene, ustrezni elementi polj pa postanejo null. Tudi NaN in neskončnosti postanejo null. Cikli in nekonvertirane vrednosti BigInt povzročijo TypeError. Zato ponovno serializiranje in razčlenjevanje nista splošna metoda za globoko kopiranje.

Ta vnos in primer obravnavata osnovne metode, ne pa celotnega nabora novejših razširitev. Trenutni osnutek specifikacije opisuje tudi JSON.rawJSON in JSON.isRawJSON; pred uporabo preverite, ali sta na voljo v ciljnem okolju. Rezultat v Node 24 ne dokazuje podpore v brskalnikih.

Primeri

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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri