Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

JSON.stringify: z hodnoty JavaScriptu na text JSON

JSON.stringify serializuje hodnotu JavaScriptu do textu JSON; voliteľný replacer vyberá či mení údaje a space riadi odsadenie.

Verzia: ECMAScript 5 onward; well-formed lone-surrogate escaping from ECMAScript 2019; example target: Node.js 24.22.2

Syntax

JSON.stringify(value[, replacer[, space]])

JSON.stringify(value, replacer?, space?) vracia reťazec JSON, alebo undefined, ak je hodnotou najvyššej úrovne undefined, funkcia či Symbol. V objekte sa také hodnoty vynechajú, ale v poli sa zmenia na null; NaN a nekonečno sa tiež zmenia na null, zatiaľ čo -0 sa zapíše ako 0. Serializujú sa vlastné vyčísliteľné vlastnosti s reťazcovými kľúčmi v definovanom poradí Object.keys; kľúče Symbol sa ignorujú. Opis vlastných vyčísliteľných vlastností platí pre predvolený zoznam; pole replacera číta pomenované vlastnosti pomocou Get a môže zahrnúť zdedenú či nevyčísliteľnú.

Existujúca metóda toJSON sa spustí pred replacer. Funkcia replacer dostane (key, value), jej this je držiteľ, a môže hodnotu nahradiť alebo vlastnosť vynechať vrátením undefined; koreňové volanie používa prázdny kľúč "". Pole replacera tvorí zoznam povolených názvov vlastností objektov. Číselné space je obmedzené na 10 medzier a reťazcové na prvých 10 znakov. Pri reťazcovom space znamená „10 znakov“ presne prvých 10 kódových jednotiek UTF-16.

Cyklický odkaz vyvolá TypeError. BigInt ho tiež vyvolá, ak bežné vyhľadanie vlastnosti nenájde volateľnú metódu toJSON; metóda môže pochádzať z prototypu. Výnimky z gettera, toJSON alebo replacera sa šíria ďalej. Stabilné poradie vlastností neznamená kanonický JSON pre kryptografický podpis. Metóda je štandardná od ECMAScript 5; od ECMAScript 2019 sa osamelé náhradné znaky Unicode zapisujú ako sekvencie \ud800–\udfff, takže výsledok je platný Unicode.

Príklady

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

Výsledok

{"name":"Ada","numbers":[1,null,null,null],"nested":{"keep":true}}
true
true
true

Zdroje