CKTIS / JavaScript
JSON.stringify: от JavaScript стойност към JSON текст
JSON.stringify сериализира JavaScript стойност като JSON текст; незадължителен replacer избира или преобразува данни, а space управлява отстъпа.
Версия: ECMAScript 5 onward; well-formed lone-surrogate escaping from ECMAScript 2019; example target: Node.js 24.22.2
Синтаксис
JSON.stringify(value[, replacer[, space]])JSON.stringify(value, replacer?, space?) връща JSON низ или undefined, когато стойността от най-горно ниво е undefined, функция или Symbol. Такива стойности се пропускат в обект, но стават null в масив; NaN и безкрайностите също стават null, а -0 се записва като 0. Сериализират се собствени изброими свойства с низови ключове в определения ред на Object.keys; Symbol ключовете се игнорират. Описанието на собствените изброими свойства важи за стандартния списък; масив replacer чете именувани свойства чрез Get и може да включи наследено или неизброимо.
Съществуващ метод toJSON се изпълнява преди replacer. Функция replacer получава (key, value), като this е държателят, и може да замени стойността или да пропусне свойство чрез връщане на undefined; извикването за корена използва празния ключ "". Масив replacer образува списъка с разрешени имена на свойства на обекти. Числовото space е ограничено до 10 интервала, а низовото до първите 10 знака. За низов space „10 знака“ означава точно първите 10 кодови единици UTF-16.
Циклична връзка хвърля TypeError. BigInt също го хвърля, освен ако обикновено търсене на свойство намери извикваем toJSON; методът може да идва от прототипа. Изключенията от getter, toJSON или replacer се разпространяват. Стабилният ред на свойствата не прави резултата каноничен JSON за криптографско подписване. Методът е стандартен от ECMAScript 5; от ECMAScript 2019 единичните Unicode сурогати се извеждат като \ud800–\udfff, така че резултатът е коректен Unicode.
Примери
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);
}Резултат
{"name":"Ada","numbers":[1,null,null,null],"nested":{"keep":true}}
true
true
true