CKTIS / JavaScript
JSON.stringify: z hodnoty JavaScriptu na text JSON
JSON.stringify serializuje hodnotu JavaScriptu do textu JSON; volitelný replacer vybírá či mění data a space řídí odsazení.
Verze: ECMAScript 5 onward; well-formed lone-surrogate escaping from ECMAScript 2019; example target: Node.js 24.22.2
Syntaxe
JSON.stringify(value[, replacer[, space]])JSON.stringify(value, replacer?, space?) vrací řetězec JSON, nebo undefined, je-li hodnotou nejvyšší úrovně undefined, funkce či Symbol. V objektu se takové hodnoty vynechají, ale v poli se změní na null; NaN a nekonečna se také změní na null, zatímco -0 se zapíše jako 0. Serializují se vlastní vyčíslitelné vlastnosti s řetězcovými klíči v definovaném pořadí Object.keys; klíče Symbol se ignorují. Popis vlastních vyčíslitelných vlastností platí pro výchozí seznam; pole replaceru čte pojmenované vlastnosti pomocí Get a může zahrnout zděděnou či nevyčíslitelnou.
Existující metoda toJSON se spustí před replacer. Funkce replacer obdrží (key, value), její this je držitel, a může hodnotu nahradit nebo vlastnost vynechat vrácením undefined; kořenové volání používá prázdný klíč "". Pole replaceru tvoří seznam povolených názvů vlastností objektů. Číselné space je omezeno na 10 mezer a řetězcové na prvních 10 znaků. U řetězcového space znamená „10 znaků“ přesně prvních 10 kódových jednotek UTF-16.
Cyklický odkaz vyvolá TypeError. BigInt jej také vyvolá, pokud běžné vyhledání vlastnosti nenajde volatelnou metodu toJSON; metoda může pocházet z prototypu. Výjimky z getteru, toJSON nebo replaceru se šíří dál. Stabilní pořadí vlastností neznamená kanonický JSON pro kryptografický podpis. Metoda je standardní od ECMAScript 5; od ECMAScript 2019 se osamocené náhradní znaky Unicode zapisují jako sekvence \ud800–\udfff, takže výsledek je platný Unicode.
Pří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ýsledek
{"name":"Ada","numbers":[1,null,null,null],"nested":{"keep":true}}
true
true
true