CKTIS / JavaScript
JSON.stringify: iz JavaScript vrijednosti u JSON tekst
JSON.stringify serijalizira JavaScript vrijednost u JSON tekst; neobavezni replacer odabire ili mijenja podatke, a space upravlja uvlačenjem.
Verzija: ECMAScript 5 onward; well-formed lone-surrogate escaping from ECMAScript 2019; example target: Node.js 24.22.2
Sintaksa
JSON.stringify(value[, replacer[, space]])JSON.stringify(value, replacer?, space?) vraća JSON niz znakova ili undefined kada je vršna vrijednost undefined, funkcija ili Symbol. Takve se vrijednosti izostavljaju u objektu, ali u polju postaju null; NaN i beskonačnosti također postaju null, dok se -0 zapisuje kao 0. Serijaliziraju se vlastita nabrojiva svojstva s nizovnim ključevima u definiranom redoslijedu Object.keys; Symbol ključevi se zanemaruju. Opis vlastitih nabrojivih svojstava vrijedi za zadani popis; polje replacera čita imenovana svojstva pomoću Get i može uključiti naslijeđeno ili nenabrojivo.
Postojeća metoda toJSON izvodi se prije replacer. Funkcija replacer prima (key, value), njezin this je sadržavatelj, i može zamijeniti vrijednost ili izostaviti svojstvo vraćanjem undefined; korijenski poziv koristi prazan ključ "". Polje replacera tvori popis dopuštenih naziva svojstava objekata. Brojčani space ograničen je na 10 razmaka, a nizovni na prvih 10 znakova. Za nizovni space „10 znakova“ znači točno prvih 10 kodnih jedinica UTF-16.
Kružna referenca baca TypeError. BigInt ga također baca osim ako obično traženje svojstva pronađe pozivajuću metodu toJSON; metoda može doći s prototipa. Iznimke iz gettera, toJSON ili replacera šire se dalje. Stabilni redoslijed svojstava ne čini izlaz kanonskim JSON-om za kriptografsko potpisivanje. Metoda je standardna od ECMAScript 5; od ECMAScript 2019 osamljeni Unicode surogati ispisuju se kao sekvence \ud800–\udfff, pa je rezultat valjani Unicode.
Primjeri
const value = {
name: "Ada",
missing: undefined,
numbers: [1, NaN, Infinity, undefined],
nested: { keep: true, secret: "hidden" },
};
console.log(JSON.stringify(value, (key, current) =>
key === "secret" ? undefined : current,
));
console.log(JSON.stringify(undefined) === undefined);
try {
JSON.stringify(1n);
} catch (error) {
console.log(error instanceof TypeError);
}
const cycle = {};
cycle.self = cycle;
try {
JSON.stringify(cycle);
} catch (error) {
console.log(error instanceof TypeError);
}Rezultat
{"name":"Ada","numbers":[1,null,null,null],"nested":{"keep":true}}
true
true
true