База знанияИзпитен център
BGБългарски
Избери език13

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

Източници