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