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

CKTIS / JavaScript

JSON.stringify: iz vrednosti JavaScript v besedilo JSON

JSON.stringify serializira vrednost JavaScript v besedilo JSON; izbirni replacer izbere ali spremeni podatke, space pa določa zamik.

Različica: 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?) vrne niz JSON ali undefined, če je vrhnja vrednost undefined, funkcija ali Symbol. Take vrednosti so v objektu izpuščene, v polju pa postanejo null; NaN in neskončnosti prav tako postanejo null, -0 pa se zapiše kot 0. Serializirajo se lastne naštevne lastnosti z nizovnimi ključi v določenem vrstnem redu Object.keys; ključi Symbol so prezrti. Opis lastnih naštevnih lastnosti velja za privzeti seznam; polje replacer bere imenovane lastnosti z Get in lahko vključi podedovano ali nenaštevno.

Obstoječa metoda toJSON se izvede pred replacer. Funkcija replacer prejme (key, value), njen this je vsebnik, in lahko vrednost zamenja ali lastnost izpusti z vrnitvijo undefined; korenski klic uporablja prazen ključ "". Polje replacer tvori seznam dovoljenih imen lastnosti objektov. Številčni space je omejen na 10 presledkov, nizovni pa na prvih 10 znakov. Pri nizovnem space »10 znakov« pomeni natanko prvih 10 kodnih enot UTF-16.

Krožni sklic sproži TypeError. Tudi BigInt ga sproži, razen če običajno iskanje lastnosti najde izvedljivo metodo toJSON; metoda lahko pride iz prototipa. Izjeme iz getterja, toJSON ali replacerja se razširijo naprej. Stabilni vrstni red lastnosti ne pomeni kanoničnega JSON za kriptografsko podpisovanje. Metoda je standardna od ECMAScript 5; od ECMAScript 2019 se osamljeni nadomestni znaki Unicode izpišejo kot zaporedja \ud800–\udfff, zato je rezultat veljaven Unicode.

Primeri

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

Viri